--- chapter.sgml.orig	Sat Sep  3 14:52:36 2005
+++ chapter.sgml.2	Tue Sep  6 22:36:41 2005
@@ -119,15 +119,20 @@
 	  </indexterm>
 	  <para>A null-modem cable passes some signals, such as <quote>signal
 	    ground</quote>, straight through, but switches other signals.  For
-	    example, the <quote>send data</quote> pin on one end goes to the
-	    <quote>receive data</quote> pin on the other end.</para>
+	    example, the <quote>transmitted data</quote> pin on one end goes to the
+	    <quote>received data</quote> pin on the other end.</para>
 	      
-	  <para>If you like making your own cables, you can construct
-	    a null-modem cable for use with
-	    terminals.  This table shows the RS-232C signal names and the pin
-	    numbers on a DB-25 connector.</para>
+	  <para>You can also construct your own null-modem cable for use with
+	    terminals (e.g., for quality purposes).  This table shows the RS-232C
+	    signal names and the pin numbers on a DB-25 connector.  Note that the
+	    standard also calls for a straight-through pin 1 to pin 1
+	    <emphasis>protective ground</emphasis> line, but it is often omitted.
+	    Some terminals can get by using only pins 2, 3 and 7, while others
+	    require different configurations than the examples shown below.</para>
 
-	  <informaltable frame="none" pgwide="1">
+	  <table frame="none" pgwide="1">
+	    <title>Null-modem DB-25 to DB-25 cable</title>
+		
 	    <tgroup cols="5">
 	      <thead>
 		<row>
@@ -189,11 +194,11 @@
 		</row>
 		
 		<row>
-		  <entry>DCD</entry>
+		  <entry>DTR</entry>
+		  <entry>20</entry>
+		  <entry>connects to</entry>
 		  <entry>8</entry>
-		  <entry></entry>
-		  <entry>6</entry>
-		  <entry>DSR</entry>
+		  <entry>DCD</entry>
 		</row>
 		
 		<row>
@@ -203,16 +208,269 @@
 		  <entry>20</entry>
 		  <entry>DTR</entry>
 		</row>
+		
+		<row>
+		  <entry>DCD</entry>
+		  <entry>8</entry>
+		  <entry>connects to</entry>
+		  <entry>20</entry>
+		  <entry>DTR</entry>
+		</row>
 	      </tbody>
 	    </tgroup>
-	  </informaltable>
+	  </table>
 	  
+	  <para>Here are two other schemes more common nowadays.</para>
+
+          <table frame="none" pgwide="1">
+            <title>Null-modem DB-9 to DB-9 cable</title>
+
+            <tgroup cols="5">
+              <thead>
+                <row>
+                  <entry>Signal</entry>
+                  <entry>Pin #</entry>
+                  <entry></entry>
+                  <entry>Pin #</entry>
+                  <entry>Signal</entry>
+                </row>
+              </thead>
+
+              <tbody>
+                <row>
+                  <entry>RD</entry>
+                  <entry>2</entry>
+                  <entry>connects to</entry>
+                  <entry>3</entry>
+                  <entry>TD</entry>
+                </row>
+
+                <row>
+                  <entry>TD</entry>
+                  <entry>3</entry>
+                  <entry>connects to</entry>
+                  <entry>2</entry>
+                  <entry>RD</entry>
+                </row>
+
+                <row>
+                  <entry>DTR</entry>
+                  <entry>4</entry>
+                  <entry>connects to</entry>
+                  <entry>6</entry>
+                  <entry>DSR</entry>
+                </row>
+
+                <row>
+                  <entry>DTR</entry>
+                  <entry>4</entry>
+                  <entry>connects to</entry>
+                  <entry>1</entry>
+                  <entry>DCD</entry>
+                </row>
+
+                <row>
+                  <entry>SG</entry>
+                  <entry>5</entry>
+                  <entry>connects to</entry>
+                  <entry>5</entry>
+                  <entry>SG</entry>
+                </row>
+
+                <row>
+                  <entry>DSR</entry>
+                  <entry>6</entry>
+                  <entry>connects to</entry>
+                  <entry>4</entry>
+                  <entry>DTR</entry>
+                </row>
+
+                <row>
+                  <entry>DCD</entry>
+                  <entry>1</entry>
+                  <entry>connects to</entry>
+                  <entry>4</entry>
+                  <entry>DTR</entry>
+                </row>
+
+                <row>
+                  <entry>RTS</entry>
+                  <entry>7</entry>
+                  <entry>connects to</entry>
+                  <entry>8</entry>
+                  <entry>CTS</entry>
+                </row>
+
+                <row>
+                  <entry>CTS</entry>
+                  <entry>8</entry>
+                  <entry>connects to</entry>
+                  <entry>7</entry>
+                  <entry>RTS</entry>
+                </row>
+              </tbody>
+            </tgroup>
+          </table>
+
+          <table frame="none" pgwide="1">
+            <title>Null-modem DB-9 to DB-25 cable</title>
+
+            <tgroup cols="5">
+              <thead>
+                <row>
+                  <entry>Signal</entry>
+                  <entry>Pin #</entry>
+                  <entry></entry>
+                  <entry>Pin #</entry>
+                  <entry>Signal</entry>
+                </row>
+              </thead>
+
+              <tbody>
+                <row>
+                  <entry>RD</entry>
+                  <entry>2</entry>
+                  <entry>connects to</entry>
+                  <entry>2</entry>
+                  <entry>TD</entry>
+                </row>
+
+                <row>
+                  <entry>TD</entry>
+                  <entry>3</entry>
+                  <entry>connects to</entry>
+                  <entry>3</entry>
+                  <entry>RD</entry>
+                </row>
+
+                <row>
+                  <entry>DTR</entry>
+                  <entry>4</entry>
+                  <entry>connects to</entry>
+                  <entry>6</entry>
+                  <entry>DSR</entry>
+                </row>
+
+                <row>
+                  <entry>DTR</entry>
+                  <entry>4</entry>
+                  <entry>connects to</entry>
+                  <entry>8</entry>
+                  <entry>DCD</entry>
+                </row>
+
+                <row>
+                  <entry>SG</entry>
+                  <entry>5</entry>
+                  <entry>connects to</entry>
+                  <entry>7</entry>
+                  <entry>SG</entry>
+                </row>
+
+                <row>
+                  <entry>DSR</entry>
+                  <entry>6</entry>
+                  <entry>connects to</entry>
+                  <entry>20</entry>
+                  <entry>DTR</entry>
+                </row>
+
+                <row>
+                  <entry>DCD</entry>
+                  <entry>1</entry>
+                  <entry>connects to</entry>
+                  <entry>20</entry>
+                  <entry>DTR</entry>
+                </row>
+
+                <row>
+                  <entry>RTS</entry>
+                  <entry>7</entry>
+                  <entry>connects to</entry>
+                  <entry>5</entry>
+                  <entry>CTS</entry>
+                </row>
+
+                <row>
+                  <entry>CTS</entry>
+                  <entry>8</entry>
+                  <entry>connects to</entry>
+                  <entry>4</entry>
+                  <entry>RTS</entry>
+                </row>
+              </tbody>
+            </tgroup>
+          </table>
+
 	  <note>
-	    <para>Connect <quote>Data Set Ready</quote> (DSR) and
-	      <quote>Data Carrier Detect</quote> (DCD) internally in the
-	      connector hood, and then to <quote>Data Terminal
-	        Ready</quote> (DTR) in the remote hood.</para>
+	    <para>Usually, when one pin at one end connects to a pair of pins
+	      at the other end, it is implemented with one short wire between
+	      the pair of pins in their connector and a long wire to the other
+	      single pin.</para>
 	  </note>
+
+	  <para>The above designs seems to be the most popular.  In another
+	    variation (explained in the book <emphasis>RS-232 Made
+	      Easy</emphasis>, ISBN: 0137498543) SG connects to SG, TD connects
+	    to RD, RTS and CTS connect to DCD, DTR connects to DSR, and
+	    vice-versa.</para>
+
+          <para>The correspondance between acronyms used and signal names
+            follow.</para>
+
+          <table frame="none" pgwide="1">
+            <title>Signal acronyms</title>
+
+            <tgroup cols="5">
+              <thead>
+                <row>
+                  <entry>Acronyms</entry>
+                  <entry>Signal names</entry>
+                </row>
+              </thead>
+
+              <tbody>
+                <row>
+                  <entry>RD</entry>
+                  <entry>Received Data</entry>
+                </row>
+
+                <row>
+                  <entry>TD</entry>
+                  <entry>Transmitted Data</entry>
+                </row>
+
+                <row>
+                  <entry>DTR</entry>
+                  <entry>Data Terminal Ready</entry>
+                </row>
+
+                <row>
+                  <entry>DSR</entry>
+                  <entry>Data Set Ready</entry>
+                </row>
+
+                <row>
+                  <entry>DCD</entry>
+                  <entry>Data Carrier Detect</entry>
+                </row>
+
+                <row>
+                  <entry>SG</entry>
+                  <entry>System Ground</entry>
+                </row>
+
+                <row>
+                  <entry>RTS</entry>
+                  <entry>Request To Send</entry>
+                </row>
+
+                <row>
+                  <entry>CTS</entry>
+                  <entry>Clear To Send</entry>
+                </row>
+             </tbody>
+          </table>
 	</sect4>
 
 	<sect4 id="term-cables-std">
@@ -220,8 +478,8 @@
 	  <indexterm><primary>RS-232C cables</primary></indexterm>
 
 	  <para>A standard serial cable passes all the RS-232C signals
-	    straight-through.  That is, the <quote>send data</quote> pin on one
-	    end of the cable goes to the <quote>send data</quote> pin on the
+	    straight-through.  That is, the <quote>transmitted data</quote> pin on one
+	    end of the cable goes to the <quote>transmitted data</quote> pin on the
 	    other end. This is the type of cable to use to connect a modem to your
 	    FreeBSD system, and is also appropriate for some
 	    terminals.</para>
