Date: Tue, 6 May 2008 20:05:32 +0200 From: "Gabor PALI" <pgj@FreeBSD.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/123471: [patch] Add Missing COM Device Names for 6.X Series in Handbook Chapter 25 Message-ID: <48209def.02a1660a.7e85.1bd3@mx.google.com> Resent-Message-ID: <200805061810.m46IA18k008232@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?48209def.02a1660a.7e85.1bd3>