docs/123471: [patch] Add Missing COM Device Names for 6.X Series in Handbook Chapter 25

[Gabor PALI]

>Number:         123471
>Category:       docs
>Synopsis:       [patch] Add Missing COM Device Names for 6.X Series in Handbook Chapter 25
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue May 06 18:10:01 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Gabor PALI
>Release:        FreeBSD 6.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD disznohal 6.3-STABLE FreeBSD 6.3-STABLE #4: Fri Apr 4 23:29:43 CEST 2008 dezzy at disznohal:/usr/obj/usr/src/sys/GENERIC_ i386

>Description:
	Certain sections about COM ports forget to mention their changed
	device names (like cuaaN -> cuadN) in the recent FreeBSD versions
	in the FreeBSD Handbook, Chapter 25 (``PPP and SLIP''). I created
	a patch to fix this.


>How-To-Repeat:

>Fix:

--- ppp-and-slip.patch.1.diff begins here ---
Index: chapter.sgml
===================================================================
RCS file: /doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
retrieving revision 1.177
diff -u -r1.177 chapter.sgml
--- chapter.sgml	3 Feb 2008 23:12:02 -0000	1.177
+++ chapter.sgml	6 May 2008 03:27:54 -0000
@@ -339,9 +339,9 @@
 	      <listitem>
 		<para>Identifies the device to which the modem is
 		  connected.  <devicename>COM1</devicename> is
-		  <filename>/dev/cuaa0</filename> and
+		  <filename>/dev/cuaa0</filename> (or <filename>/dev/cuad0</filename> under &os; 6.X) and
 		  <devicename>COM2</devicename> is
-		  <filename>/dev/cuaa1</filename>.</para>
+		  <filename>/dev/cuaa1</filename> (or <filename>/dev/cuad1</filename>).</para>
 	      </listitem>
 	    </varlistentry>
 
@@ -1758,7 +1758,7 @@
 	  required to rebuild the kernel.
 	  When matching up sio modem is on <devicename>sio1</devicename> or
           <devicename>COM2</devicename> if you are in DOS, then your
-	  modem device would be <filename>/dev/cuaa1</filename>.</para>
+	  modem device would be <filename>/dev/cuaa1</filename> (or <filename>/dev/cuad1</filename> under &os; 6.X).</para>
     </sect2>
 
     <sect2>
@@ -1782,7 +1782,7 @@
       <screen>ppp ON example> <userinput>set device <filename>/dev/cuaa1</filename></userinput></screen>
 
       <para>We set our modem device, in this case it is
-	<devicename>cuaa1</devicename>.</para>
+	<devicename>cuaa1</devicename> (or <devicename>cuad1</devicename> under &os; 6.X).</para>
 
       <screen>ppp ON example> <userinput>set speed 115200</userinput></screen>
 
@@ -2415,7 +2415,7 @@
       <para>First, determine which serial port your modem is connected to.
 	Many people set up a symbolic link, such as
 	<filename>/dev/modem</filename>, to point to the real device name,
-	<filename>/dev/cuaaN</filename> (or <filename>/dev/cuadN</filename> under &os; 6.X).  This allows you to
+	<filename>/dev/cuaa<replaceable>N</replaceable></filename> (or <filename>/dev/cuad<replaceable>N</replaceable></filename> under &os; 6.X).  This allows you to
 	abstract the actual device name should you ever need to move
 	the modem to a different port.  It can become quite cumbersome when you
 	need to fix a bunch of files in <filename>/etc</filename> and
--- ppp-and-slip.patch.1.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: