--- chapter.sgml.orig	Fri Sep  9 20:51:48 2005
+++ chapter.sgml.4	Fri Sep  9 21:59:16 2005
@@ -117,17 +117,23 @@
 	  <indexterm>
 	    <primary>null-modem cable</primary>
 	  </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>
+	  <para>A null-modem cable passes some signals, such as <quote>Signal
+	    Ground</quote>, straight-through, but switches other signals.  For
+	    example, the <quote>Transmitted Data</quote> pin on one end goes to the
+	    <quote>Deceived 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
+	    <link linkend="serialcomms-signal-names">signals</link> 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>DB-25 to DB-25 Null-Modem Cable</title>
+		
 	    <tgroup cols="5">
 	      <thead>
 		<row>
@@ -189,11 +195,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,25 +209,220 @@
 		  <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>DB-9 to DB-9 Null-Modem 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>DB-9 to DB-25 Null-Modem 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>When one pin at one end connects to a pair of pins
+	      at the other end, it is usually 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>) SG connects to SG, TD connects to RD, RTS and
+	    CTS connect to DCD, DTR connects to DSR, and vice-versa.</para>
 	</sect4>
 
 	<sect4 id="term-cables-std">
 	  <title>Standard RS-232C Cables</title>
 	  <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
+	  <para>A standard serial cable passes all of the RS-232C signals
+	    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>
@@ -243,8 +444,8 @@
 	    construct a cable, you need to make sure it will fit the ports on
 	    your terminal and on the FreeBSD system.</para>
 	      
-	  <para>Most terminals will have DB25 ports.  Personal computers,
-	    including PCs running FreeBSD, will have DB25 or DB9 ports. If you
+	  <para>Most terminals will have DB-25 ports.  Personal computers,
+	    including PCs running FreeBSD, will have DB-25 or DB-9 ports. If you
 	    have a multiport serial card for your PC, you may have RJ-12 or
 	    RJ-45 ports.</para>
 	      
@@ -976,39 +1177,60 @@
 	  cable should suffice as long as all of the normal signals
 	  are wired:</para>
 
-	<itemizedlist>
-	  <listitem>
-	    <para>Transmitted Data (<acronym>TD</acronym>)</para>
-	  </listitem>
-	  
-	  <listitem>
-	    <para>Received Data (<acronym>RD</acronym>)</para>
-	  </listitem>
-	  
-	  <listitem>
-	    <para>Request to Send (<acronym>RTS</acronym>)</para>
-	  </listitem>
-	  
-	  <listitem>
-	    <para>Clear to Send (<acronym>CTS</acronym>)</para>
-	  </listitem>
-	  
-	  <listitem>
-	    <para>Data Set Ready (<acronym>DSR</acronym>)</para>
-	  </listitem>
-	  
-	  <listitem>
-	    <para>Data Terminal Ready (<acronym>DTR</acronym>)</para>
-	  </listitem>
-	  
-	  <listitem>
-	    <para>Carrier Detect (<acronym>CD</acronym>)</para>
-	  </listitem>
-	  
-	  <listitem>
-	    <para>Signal Ground (<acronym>SG</acronym>)</para>
-	  </listitem>
-	</itemizedlist>
+          <table frame="none" pgwide="1" id="serialcomms-signal-names">
+            <title>Signal Names</title>
+
+            <tgroup cols="5">
+              <thead>
+                <row>
+                  <entry>Acronyms</entry>
+                  <entry>Names</entry>
+                </row>
+              </thead>
+
+              <tbody>
+                <row>
+                  <entry><acronym>RD</acronym></entry>
+                  <entry>Received Data</entry>
+                </row>
+
+                <row>
+                  <entry><acronym>TD</acronym></entry>
+                  <entry>Transmitted Data</entry>
+                </row>
+
+                <row>
+                  <entry><acronym>DTR</acronym></entry>
+                  <entry>Data Terminal Ready</entry>
+                </row>
+
+                <row>
+                  <entry><acronym>DSR</acronym></entry>
+                  <entry>Data Set Ready</entry>
+                </row>
+
+                <row>
+                  <entry><acronym>DCD</acronym></entry>
+                  <entry>Data Carrier Detect (RS-232's Received Line
+                    Signal Detector)</entry>
+                </row>
+
+                <row>
+                  <entry><acronym>SG</acronym></entry>
+                  <entry>Signal Ground</entry>
+                </row>
+
+                <row>
+                  <entry><acronym>RTS</acronym></entry>
+                  <entry>Request to Send</entry>
+                </row>
+
+                <row>
+                  <entry><acronym>CTS</acronym></entry>
+                  <entry>Clear to Send</entry>
+                </row>
+             </tbody>
+          </table>
 
 	<para>FreeBSD needs the <acronym>RTS</acronym> and
 	  <acronym>CTS</acronym> signals for flow-control at speeds above
