Index: trunk/doc/tutorial/simulation/sim/01_dc/index.html
===================================================================
--- trunk/doc/tutorial/simulation/sim/01_dc/index.html	(revision 8940)
+++ trunk/doc/tutorial/simulation/sim/01_dc/index.html	(revision 8941)
@@ -165,6 +165,16 @@
 setups each having different sources installed at random parts of the circuit.
 Without modifications, all sources of all simulation setups would need to be
 added to the drawing (or on separate "test bench sheets").
+<p>
+Note: CN1-2 uses component name - <i>port name</i>;
+<i>port name</i> means the name the port is listed by in the abstract
+model, which is typically the original terminal name, and not the
+"pin number", or the calculated display/name attribute. In case oc CN1-2, port
+name and "pin number" or display/name happens to match, but for example using
+a polarized symbol, e.g. a diode it is typically A and C (not 1 and 2);
+or using a transistor symbol, the port names are B, E, C (and not 1, 2 and 3).
+Tip: switch to the raw view to reveal the original port names or use the
+abstract model dialog to find them.
 
 <h3> Sim setup: output config </h3>
 <p>
Index: trunk/doc/user/06_features/simulation/index.html
===================================================================
--- trunk/doc/user/06_features/simulation/index.html	(revision 8940)
+++ trunk/doc/user/06_features/simulation/index.html	(revision 8941)
@@ -126,6 +126,14 @@
 address is either the name of an <i>abstract network</i> or a pair of
 <i>abstract component</i> and <i>port name</i>, e.g. CN2-4 means "port 4
 of component CN2".
+<p>
+Note: <i>port name</i> means the name the port is listed by in the abstract
+model, which is typically the original terminal name, and not the
+"pin number", or the calculated display/name attribute. For example using
+a polarized symbol, e.g. a diode it is typically A and C (not 1 and 2);
+or using a transistor symbol, the port names are B, E, C (and not 1, 2 and 3).
+Tip: switch to the raw view to reveal the original port names or use the
+abstract model dialog to find them.
 
 <h4 autotoc="yes"> config subtree in project.lht </h4>
 <p>