From nobody@FreeBSD.org  Fri Aug 17 08:15:48 2001
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0878237B408
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 17 Aug 2001 08:15:48 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id f7HFFlv68942;
	Fri, 17 Aug 2001 08:15:47 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200108171515.f7HFFlv68942@freefall.freebsd.org>
Date: Fri, 17 Aug 2001 08:15:47 -0700 (PDT)
From: John Murphy <jfm@blueyonder.co.uk>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook Chapter 12 (Disks) minor changes
X-Send-Pr-Version: www-1.0

>Number:         29806
>Category:       docs
>Synopsis:       Handbook Chapter 12 (Disks) minor changes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Aug 17 08:20:01 PDT 2001
>Closed-Date:    Sun Aug 19 16:58:59 PDT 2001
>Last-Modified:  Sun Aug 19 16:59:06 PDT 2001
>Originator:     John Murphy
>Release:        4.x Stable
>Organization:
>Environment:
>Description:
doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml Revision 1.52

Removed <filename> and <command> elements where they were within <title>.
Fixed some minor typos.

Also, there seems to be a problem with the way <userinput> and <application>
elements appear when used within <procedure><step>.  See 12.5.1 steps 2 and 3.
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/disks-adding.html

>How-To-Repeat:

>Fix:
Apply the following diff to:
doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml

--- chapter	Fri Aug 17 16:01:01 2001
+++ chapter.patched	Fri Aug 17 16:01:01 2001
@@ -125,7 +125,7 @@
     <indexterm><primary>IDE</primary></indexterm>
     <indexterm><primary>SCSI</primary></indexterm>
     <indexterm><primary>RAID</primary></indexterm>
-    <indexterm><primary>fash memory</primary></indexterm>
+    <indexterm><primary>flash memory</primary></indexterm>
     <para>Physical drives come in two main flavors,
       <acronym>IDE</acronym>, or <acronym>SCSI</acronym>; but there
       are also drives backed by RAID controllers, flash memory, and so
@@ -150,7 +150,7 @@
 	  </row>
 	  <row>
 	    <entry>IDE CDROM drives</entry>
-	    <entry><literal>acd</literal> from 4.1-RELEASE,
+	    <entry><literal>acd</literal> from 4.0-RELEASE,
 	      <literal>wcd</literal> before 4.0-RELEASE.</entry>
 	  </row>
 	  <row>
@@ -249,7 +249,7 @@
       drives.</para>
 
     <sect2 id="disks-fstab">
-      <title>The <filename>fstab</filename> File</title>
+      <title>The fstab File</title>
       <indexterm>
         <primary>filesystems</primary>
 	<secondary>mounted with fstab</secondary>
@@ -455,7 +455,7 @@
     </sect2>
 
     <sect2 id="disks-umount">
-      <title>The <command>umount</command> Command</title>
+      <title>The umount Command</title>
       <indexterm>
         <primary>filesystems</primary>
         <secondary>unmounting</secondary>
@@ -498,7 +498,7 @@
     <para>Lets say we want to add a new SCSI disk to a machine that
       currently only has a single drive.  First turn off the computer
       and install the drive in the computer following the instructions
-      of the computer, controller, and drive manufacturer.  Due the
+      of the computer, controller, and drive manufacturer.  Due to the
       wide variations of procedures to do this, the details are beyond
       the scope of this document.</para>
 
@@ -1104,7 +1104,7 @@
       <para>Which tool to use to burn the CD depends on whether your CD burner
 	is ATAPI or something else. ATAPI CD burners use the <command><link
 	linkend="burncd">burncd</link></command> program that is part of
-	the base system. SCSI and USB CD burners should use the
+	the base system. SCSI and USB CD burners should use
 	<command><link linkend="cdrecord">cdrecord</link></command> from
 	the <port>sysutils/cdrtools</port> port.</para>
 

>Release-Note:
>Audit-Trail:

From: Murray Stokely <murray.stokely@windriver.com>
To: John Murphy <jfm@blueyonder.co.uk>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/29806: Handbook Chapter 12 (Disks) minor changes
Date: Fri, 17 Aug 2001 18:04:16 -0700

 On Fri, Aug 17, 2001 at 08:15:47AM -0700, John Murphy wrote:
 > Removed <filename> and <command> elements where they were within <title>.
 > Fixed some minor typos.
 
    Why is this undesirable?  I think that we want proper markup inside
 of <title>s
 
 	- Murray
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Sun Aug 19 16:58:59 PDT 2001 
State-Changed-Why:  
Applied, thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=29806 
>Unformatted:
