From pali.gabor@googlemail.com  Mon May  5 17:58:43 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 F1CF0106564A
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  5 May 2008 17:58:43 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.186])
	by mx1.freebsd.org (Postfix) with ESMTP id 7BFF68FC1D
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  5 May 2008 17:58:43 +0000 (UTC)
	(envelope-from pali.gabor@googlemail.com)
Received: by nf-out-0910.google.com with SMTP id h3so1320791nfh.33
        for <FreeBSD-gnats-submit@freebsd.org>; Mon, 05 May 2008 10:58:42 -0700 (PDT)
Received: by 10.210.71.13 with SMTP id t13mr5919115eba.42.1210010322208;
        Mon, 05 May 2008 10:58:42 -0700 (PDT)
Received: from pgj@FreeBSD.org ( [80.98.116.90])
        by mx.google.com with ESMTPS id y2sm29596859mug.1.2008.05.05.10.58.39
        (version=TLSv1/SSLv3 cipher=OTHER);
        Mon, 05 May 2008 10:58:40 -0700 (PDT)
Received: by pgj@FreeBSD.org (sSMTP sendmail emulation); Mon,  5 May 2008 19:58:38 +0200
Message-Id: <481f4ad0.02e2660a.0e0b.7a1a@mx.google.com>
Date: Mon,  5 May 2008 19:58:38 +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] Fix <devicename> Tags in Handbook Chapter 24
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         123422
>Category:       docs
>Synopsis:       [patch] Fix <devicename> Tags in Handbook Chapter 24
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gabor
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon May 05 18:00:05 UTC 2008
>Closed-Date:    Tue May 06 15:57:48 UTC 2008
>Last-Modified:  Tue May 06 15:57:48 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:
	I found the COM ports referenced in the FreeBSD Handbook, Chapter 24
	(``Serial Communications'') are not always tagged by <devicename>.
	I created a patch to correct this.

>How-To-Repeat:

>Fix:

--- serialcomms.patch.1.diff begins here ---
Index: chapter.sgml
===================================================================
RCS file: /doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml,v
retrieving revision 1.120
diff -u -r1.120 chapter.sgml
--- chapter.sgml	28 Dec 2007 11:11:43 -0000	1.120
+++ chapter.sgml	5 May 2008 03:45:34 -0000
@@ -864,7 +864,7 @@
 
 	<para>The <filename>/etc/ttys</filename> file lists all of the ports
 	  on your FreeBSD system where you want to allow logins.  For example,
-	  the first virtual console <filename>ttyv0</filename> has an entry in
+	  the first virtual console <devicename>ttyv0</devicename> has an entry in
 	  this file.  You can log in on the console using this entry.  This
 	  file also contains entries for the other virtual consoles, serial ports,
 	  and pseudo-ttys.  For a hardwired terminal, just list the serial
@@ -875,8 +875,8 @@
 
 	<para>A default FreeBSD install includes an
 	  <filename>/etc/ttys</filename> file with support for the first
-	  four serial ports: <filename>ttyd0</filename> through
-	  <filename>ttyd3</filename>.  If you are attaching a terminal
+	  four serial ports: <devicename>ttyd0</devicename> through
+	  <devicename>ttyd3</devicename>.  If you are attaching a terminal
 	  to one of those ports, you do not need to add another entry.</para>
 
 	<example id="ex-etc-ttys">
@@ -1054,7 +1054,7 @@
 	<para>You should see an entry for the terminal.  For
 	  example, the following display shows that a
 	  <command>getty</command> is running on the second serial
-	  port <literal>ttyd1</literal> and is using the
+	  port <devicename>ttyd1</devicename> and is using the
 	  <literal>std.38400</literal> entry in
 	  <filename>/etc/gettytab</filename>:</para>
 
@@ -1443,7 +1443,7 @@
 	<programlisting>ttyd0   "/usr/libexec/getty <replaceable>xxx</replaceable>"   dialup on</programlisting>
 
 	<para>The first item in the above line is the device special file for
-	  this entry &mdash; <literal>ttyd0</literal> means
+	  this entry &mdash; <devicename>ttyd0</devicename> means
 	  <filename>/dev/ttyd0</filename> is the file that this
 	  <command>getty</command> will be watching.  The second item,
 	  <literal>"/usr/libexec/getty
@@ -1726,7 +1726,7 @@
 
 	<para>If you do not see any <command>getty</command> processes waiting
 	  to open the desired
-	  <filename>ttyd<replaceable>N</replaceable></filename> port,
+	  <devicename>ttyd<replaceable>N</replaceable></devicename> port,
 	  double-check your entries in <filename>/etc/ttys</filename> to see
 	  if there are any mistakes there.  Also, check the log file
 	  <filename>/var/log/messages</filename> to see if there are any log
@@ -2151,7 +2151,7 @@
 	  <para>Edit <filename>/etc/ttys</filename> and change
 	    <literal>off</literal> to <literal>on</literal> and
 	    <literal>dialup</literal> to <literal>vt100</literal> for the
-	    <literal>ttyd0</literal> entry.  Otherwise a password will not be
+	    <devicename>ttyd0</devicename> entry.  Otherwise a password will not be
 	    required to connect via the serial console, resulting in a
 	    potential security hole.</para>
 	</step>
@@ -2771,7 +2771,7 @@
 ttyd2 "/usr/libexec/getty std.9600" unknown off secure
 ttyd3 "/usr/libexec/getty std.9600" unknown off secure</programlisting>
 
-	<para><literal>ttyd0</literal> through <literal>ttyd3</literal>
+	<para><devicename>ttyd0</devicename> through <devicename>ttyd3</devicename>
 	  corresponds to <devicename>COM1</devicename> through
 	  <devicename>COM4</devicename>.  Change <literal>off</literal> to
 	  <literal>on</literal> for the desired port.  If you have changed the
--- serialcomms.patch.1.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->gabor 
Responsible-Changed-By: gabor 
Responsible-Changed-When: Mon May 5 22:47:14 UTC 2008 
Responsible-Changed-Why:  
Take. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/123422: commit references a PR
Date: Tue,  6 May 2008 12:49:34 +0000 (UTC)

 gabor       2008-05-06 12:49:18 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/serialcomms chapter.sgml 
   Log:
   - Use the more appropriate devicename element instead of filename
   
   PR:             docs/123422
   Submitted by:   pgj
   
   Revision  Changes    Path
   1.121     +8 -8      doc/en_US.ISO8859-1/books/handbook/serialcomms/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: Tue May 6 15:57:09 UTC 2008 
State-Changed-Why:  
Committed, thanks! 

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