From pali.gabor@googlemail.com  Tue May  6 18:06:31 2008
Return-Path: <pali.gabor@googlemail.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 3023B10656CF
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  6 May 2008 18:06:31 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: from mu-out-0910.google.com (mu-out-0910.google.com [209.85.134.190])
	by mx1.freebsd.org (Postfix) with ESMTP id 5A99A8FC35
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  6 May 2008 18:06:26 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: by mu-out-0910.google.com with SMTP id i2so417260mue.3
        for <FreeBSD-gnats-submit@freebsd.org>; Tue, 06 May 2008 11:05:36 -0700 (PDT)
Received: by 10.86.100.19 with SMTP id x19mr2062211fgb.61.1210097136148;
        Tue, 06 May 2008 11:05:36 -0700 (PDT)
Received: from pgj@FreeBSD.org ( [80.98.116.90])
        by mx.google.com with ESMTPS id j2sm4142698mue.8.2008.05.06.11.05.33
        (version=TLSv1/SSLv3 cipher=RC4-MD5);
        Tue, 06 May 2008 11:05:35 -0700 (PDT)
Received: by pgj@FreeBSD.org (sSMTP sendmail emulation); Tue,  6 May 2008 20:05:32 +0200
Message-Id: <48209def.02a1660a.7e85.1bd3@mx.google.com>
Date: Tue,  6 May 2008 20:05:32 +0200
From: "Gabor PALI" <pgj@FreeBSD.org>
Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= <pali.gabor@googlemail.com>
Reply-To: Gabor PALI <pgj@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Add Missing COM Device Names for 6.X Series in Handbook Chapter 25
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>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:    gabor
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue May 06 18:10:01 UTC 2008
>Closed-Date:    Wed May 07 15:12:34 UTC 2008
>Last-Modified:  Wed May 07 15:12:34 UTC 2008
>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;&nbsp;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;&nbsp;6.X).</para>
     </sect2>
 
     <sect2>
@@ -1782,7 +1782,7 @@
       <screen>ppp ON example&gt; <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;&nbsp;6.X).</para>
 
       <screen>ppp ON example&gt; <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;&nbsp;6.X).  This allows you to
+	<filename>/dev/cuaa<replaceable>N</replaceable></filename> (or <filename>/dev/cuad<replaceable>N</replaceable></filename> under &os;&nbsp;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:
Responsible-Changed-From-To: freebsd-doc->gabor 
Responsible-Changed-By: gabor 
Responsible-Changed-When: Tue May 6 18:42:42 UTC 2008 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=123471 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/123471: commit references a PR
Date: Wed,  7 May 2008 14:19:59 +0000 (UTC)

 gabor       2008-05-07 14:19:44 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/ppp-and-slip chapter.sgml 
   Log:
   - Make 6.X device naming scheme leading and specify the old one in parenthesis
     in each case [1]
   - Use groupname to mark up the network group instead of username [2]
   - Use replaceable element to mark up replaceable parts [3]
   
   PR:             docs/123471 (based on) [1],
                   docs/123472 [2],
                   docs/123473 [3]
   Submitted by:   pgj
   
   Revision  Changes    Path
   1.178     +19 -19    doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: gabor 
State-Changed-When: Wed May 7 15:11:26 UTC 2008 
State-Changed-Why:  
Committed with slight changes, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=123471 
>Unformatted:
