From nobody@FreeBSD.org  Mon Sep 10 23:21:08 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 723A6106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Sep 2012 23:21:08 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 5DC758FC12
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Sep 2012 23:21:08 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id q8ANL8mP086346
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 10 Sep 2012 23:21:08 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id q8ANL8xb086345;
	Mon, 10 Sep 2012 23:21:08 GMT
	(envelope-from nobody)
Message-Id: <201209102321.q8ANL8xb086345@red.freebsd.org>
Date: Mon, 10 Sep 2012 23:21:08 GMT
From: Garrett Cooper <yaneurabeya@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Serial chapter introduction mentions obsolete sio(4) interface
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         171529
>Category:       docs
>Synopsis:       Serial chapter introduction mentions obsolete sio(4) interface
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    issyl0
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 10 23:30:02 UTC 2012
>Closed-Date:    Fri Sep 14 22:05:03 UTC 2012
>Last-Modified:  Sun Feb 03 22:30:54 UTC 2013
>Originator:     Garrett Cooper
>Release:        9.1-PRERELEASE
>Organization:
EMC Isilon
>Environment:
FreeBSD wf048.west.isilon.com 9.1-RC1 FreeBSD 9.1-RC1 #0: Fri Aug 17 02:18:40 PDT 2012     root@wf048.west.isilon.com:/usr/obj/mnt/freebsd/releng/9.1/sys/ISI-GENERIC  amd64
>Description:
The link to the following page in the handbook mentions sio(4) instead of uart(4): http://www.freebsd.org/doc/en/books/handbook/serial.html#SERIAL-CABLES-PORTS . The documentation needs to be updated for FreeBSD 8.x+ as sio(4) is defunct in 8.x+:

wf048# dmesg | grep ^sio
wf048# dmesg | grep ^uart
uart0: <16550 or compatible> port 0x3f8-0x3ff irq 4 flags 0x10 on acpi0
uart0: console (115200,n,8,1)
uart1: <16550 or compatible> port 0x2f8-0x2ff irq 3 flags 0x10 on acpi0
uart2: <16550 or compatible> port 0x3e8-0x3ef irq 5 flags 0x10 on acpi0
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
Class-Changed-From-To: sw-bug->doc-bug 
Class-Changed-By: gjb 
Class-Changed-When: Tue Sep 11 01:13:40 UTC 2012 
Class-Changed-Why:  
Docs PR. 



Responsible-Changed-From-To: freebsd-bugs->freebsd-docs 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Tue Sep 11 01:13:40 UTC 2012 
Responsible-Changed-Why:  
Docs PR. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=171529 
Responsible-Changed-From-To: freebsd-docs->freebsd-doc 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Tue Sep 11 01:14:37 UTC 2012 
Responsible-Changed-Why:  
Fix assignment... 


http://www.freebsd.org/cgi/query-pr.cgi?pr=171529 
Responsible-Changed-From-To: freebsd-doc->issyl0 
Responsible-Changed-By: issyl0 
Responsible-Changed-When: Fri Sep 14 21:58:23 UTC 2012 
Responsible-Changed-Why:  
Mine, now I've submitted a patch. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/171529: commit references a PR
Date: Fri, 14 Sep 2012 21:55:45 +0000 (UTC)

 Author: issyl0
 Date: Fri Sep 14 21:55:29 2012
 New Revision: 39550
 URL: http://svn.freebsd.org/changeset/doc/39550
 
 Log:
   - Update a section of the serial communications Handbook chapter to refer
     to uart(4) in FreeBSD 8.X as opposed to the obsolete sio(4).  Keep the
     references to sio(4) but specify that they are for 7.X and older
     releases.  [1]
   - Fix some capitalisation convention errors also in the Handbook.
   
   PR:		docs/171529 [1]
   Approved by:	gjb, gabor (mentors)
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.sgml
   head/en_US.ISO8859-1/books/handbook/install/chapter.sgml
   head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
 
 Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.sgml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.sgml	Fri Sep 14 21:37:14 2012	(r39549)
 +++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.sgml	Fri Sep 14 21:55:29 2012	(r39550)
 @@ -37,7 +37,7 @@
      </authorgroup>
    </chapterinfo>
  
 -  <title>Installing &os;&nbsp;9.<replaceable>x</replaceable> and
 +  <title>Installing &os;&nbsp;9.<replaceable>X</replaceable> and
      Later</title>
  
    <sect1 id="bsdinstall-synopsis">
 
 Modified: head/en_US.ISO8859-1/books/handbook/install/chapter.sgml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/install/chapter.sgml	Fri Sep 14 21:37:14 2012	(r39549)
 +++ head/en_US.ISO8859-1/books/handbook/install/chapter.sgml	Fri Sep 14 21:55:29 2012	(r39550)
 @@ -27,7 +27,7 @@
      <!-- January 2000 -->
    </chapterinfo>
  
 -  <title>Installing &os;&nbsp;8.<replaceable>x</replaceable> and Earlier</title>
 +  <title>Installing &os;&nbsp;8.<replaceable>X</replaceable> and Earlier</title>
  
    <sect1 id="install-synopsis">
      <title>Synopsis</title>
 
 Modified: head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Fri Sep 14 21:37:14 2012	(r39549)
 +++ head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Fri Sep 14 21:55:29 2012	(r39550)
 @@ -547,16 +547,20 @@
  	for messages while the kernel is booting, or use the
  	<command>/sbin/dmesg</command> command to replay the kernel's boot
  	messages.  In particular, look for messages that start with the
 -	characters <literal>sio</literal>.</para>
 +	characters <literal>uart</literal> if you use &os;&nbsp;8.0 or
 +	higher, or <literal>sio</literal> for &os;&nbsp;7.2 or older.</para>
  
        <tip><para>To view just the messages that have the word
 -	<literal>sio</literal>, use the command:</para>
 +	<literal>uart</literal> or <literal>sio</literal> depending on the
 +	installed version of &os;, use the commands:</para>
  
 -      <screen>&prompt.root; <userinput>/sbin/dmesg | grep 'sio'</userinput></screen>
 +      <screen>&prompt.root; <userinput>/sbin/dmesg | grep 'uart'</userinput>
 +&prompt.root; <userinput>/sbin/dmesg | grep 'sio'</userinput></screen>
        </tip>
  
 -      <para>For example, on a system with four serial ports, these are the
 -	serial-port specific kernel boot messages:</para>
 +      <para>For example, on a &os;&nbsp;7.<replaceable>X</replaceable>
 +	system with four serial ports, these are the serial-port specific
 +	kernel boot messages:</para>
  
        <screen>sio0 at 0x3f8-0x3ff irq 4 on isa
  sio0: type 16550A
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: issyl0 
State-Changed-When: Fri Sep 14 22:05:00 UTC 2012 
State-Changed-Why:  
This has been fixed now in the way that you suggested.  Thanks for the 
report! 

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