From darklogik@pittgoth.com  Thu Feb 14 21:44:00 2002
Return-Path: <darklogik@pittgoth.com>
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by hub.freebsd.org (Postfix) with ESMTP id E86CB37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 14 Feb 2002 21:43:59 -0800 (PST)
Received: (from darklogik@localhost)
	by pittgoth.com (8.11.6/8.11.6) id g1F5jeE06576;
	Fri, 15 Feb 2002 00:45:40 -0500 (EST)
	(envelope-from darklogik)
Message-Id: <200202150545.g1F5jeE06576@pittgoth.com>
Date: Fri, 15 Feb 2002 00:45:40 -0500 (EST)
From: Tom Rhodes <darklogik@pittgoth.com>
Reply-To: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Handbook, cleaning prs
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         34953
>Category:       docs
>Synopsis:       [PATCH] Handbook, cleaning prs
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 14 21:50:01 PST 2002
>Closed-Date:    Fri Feb 15 12:47:04 PST 2002
>Last-Modified:  Fri Feb 15 12:47:16 PST 2002
>Originator:     
>Release:        FreeBSD 4.5 i386
>Organization:
>Environment:
System: FreeBSD localhost 4.5

>Description:
Handbook incorrect about how to add another
hard disk using sysinstall(8), corrected.  Added some
troubleshooting information to the install chapter, Andy
I really liked your patch, but I added some to it and changed
the wording a bit, hope you do not mind.  Removed the remark
about "avoiding X Windows" and replaced it with something a
tad bit more friendly.  Quick grammer fix!  I used diff -ru (as
you can see from the patch, and I have tested and aspelled it)
This pr also succeeds in closing pr: 34074 pr: 34524 and pr: 32901
>How-To-Repeat:
Look at the pr database, read the handbook
>Fix:
apply this simple patch to close 3 prs not counting its
own.  Thanks




diff -ru handbook.old/disks/chapter.sgml handbook/disks/chapter.sgml
--- handbook.old/disks/chapter.sgml	Fri Feb 15 00:09:14 2002
+++ handbook/disks/chapter.sgml	Fri Feb 15 00:34:05 2002
@@ -193,18 +193,12 @@
 	    <command>/stand/sysinstall</command> and enter the
 	    <literal>Configure</literal> menu.  Within the
 	    <literal>FreeBSD Configuration Menu</literal>, scroll down and
-	    select the <literal>Partition</literal> item.  Next you should
-	    be presented with a list of hard drives installed in your
-	    system.  If you do not see <literal>da1</literal> listed, you
-	    need to recheck your physical installation and
-	    <command>dmesg</command> output in the file
-	    <filename>/var/run/dmesg.boot</filename>.</para>
+	    select the <literal>Fdisk</literal> option.</para>
 	</step>
 
 	<step>
-	  <title>FDISK Partition Editor</title>      
-	  <para>Select <literal>da1</literal> to enter the <literal>FDISK
-	      Partition Editor</literal>.  Type <userinput>A</userinput> to
+	  <title>FDISK Partition Editor</title>
+	  <para>Once inside FDISK, we can type <userinput>A</userinput> to
 	    use the entire disk for FreeBSD.  When asked if you want to
 	    <quote>remain cooperative with any future possible operating
 	      systems</quote>, answer <literal>YES</literal>.  Write the
@@ -219,13 +213,14 @@
 	  <title>Disk Label Editor</title>
 	  <indexterm><primary>BSD partitions</primary></indexterm>
 
-	  <para>Next, <application>Sysinstall</application> will
+	  <para>Next, you need to exit <application>Sysinstall</application>
+            and start it again.  Follow the directions above, although this
+            time choose the <literal>Label</literal> option. This will
 	    enter the <literal>Disk Label Editor</literal>.  This
 	    is where you will create the traditional BSD partitions.  A
 	    disk can have up to eight partitions, labeled 
 	    <literal>a-h</literal>.
-	    A few of
-	    the partition labels have special uses.  The
+	    A few of the partition labels have special uses.  The
 	    <literal>a</literal> partition is used for the root partition
 	    (<filename>/</filename>).  Thus only your system disk (e.g,
 	    the disk you boot from) should have an <literal>a</literal>
diff -ru handbook.old/install/chapter.sgml handbook/install/chapter.sgml
--- handbook.old/install/chapter.sgml	Fri Feb 15 00:09:15 2002
+++ handbook/install/chapter.sgml	Fri Feb 15 00:28:05 2002
@@ -4585,6 +4585,21 @@
         that case, the probes for the conflicting driver(s) should be
         disabled.</para>
 
+      <note>
+        <para>Some installation problems can be avoided or alleviated by
+          by updating the firmware on various hardware components, most notably
+          the motherboard.  The motherboard firmware may also be referred to
+          as <acronym>BIOS</acronym> and most of the motherboard or computer
+          manufactures have a website where the upgrades and upgrade information
+          may be located.</para>
+
+        <para>Most manufacturers strongly advise against upgrading the motherboard
+          <acronym>BIOS</acronym> unless there is a good reason for doing so, which
+          could possibly be a critical update of sorts.  The upgrade process
+          <emphasis>can</emphasis> go wrong, causing permanent damage to the
+          <acronym>BIOS</acronym> chip.</para>
+        </note>
+
       <warning>
         <para>Do not disable any drivers you will need during the
           installation, such as your screen (<devicename>sc0</devicename>).
diff -ru handbook.old/x11/chapter.sgml handbook/x11/chapter.sgml
--- handbook.old/x11/chapter.sgml	Fri Feb 15 00:09:12 2002
+++ handbook/x11/chapter.sgml	Fri Feb 15 00:40:31 2002
@@ -59,9 +59,9 @@
 	letter in the Roman alphabet.</para>
 
       <para>X can be called <quote>X</quote>, <quote>X Window System</quote>,
-	  <quote>X11</quote>, and other terms.  <quote>X Windows</quote> is
-	  to be avoided wherever possible; see &man.X.1; for more
-	  information.</para>
+	  <quote>X11</quote>, and other terms.  Calling X11
+          <quote>X Windows</quote> is can offend some people;
+          see &man.X.1; for a bit more insight on this.</para>
     </sect2>
 
     <sect2>
>Release-Note:
>Audit-Trail:

From: Andrew McKay <andy@openirc.co.uk>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/34953: [PATCH] Handbook, cleaning prs
Date: Fri, 15 Feb 2002 08:48:34 +0000 (GMT)

 On Fri, 15 Feb 2002, Tom Rhodes wrote:
 
 TR> Added some troubleshooting information to the install chapter, Andy I
 TR> really liked your patch, but I added some to it and changed the
 TR> wording a bit, hope you do not mind.
 
 I do not mind at all.  Looks...beautiful ;)
 
 -- 
 Andrew McKay <andy@openirc.co.uk>
 
 

From: Ceri <setantae@submonkey.net>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/34953: [PATCH] Handbook, cleaning prs
Date: Fri, 15 Feb 2002 10:01:07 +0000

 On Fri, Feb 15, 2002 at 12:45:40AM -0500, Tom Rhodes wrote:
 >  	<step>
 > -	  <title>FDISK Partition Editor</title>      
 > -	  <para>Select <literal>da1</literal> to enter the <literal>FDISK
 > -	      Partition Editor</literal>.  Type <userinput>A</userinput> to
 > +	  <title>FDISK Partition Editor</title>
 > +	  <para>Once inside FDISK, we can type <userinput>A</userinput> to
 
 FDISK -> fdisk ?
 
 > +	  <para>Next, you need to exit <application>Sysinstall</application>
 
 Sysinstall -> sysinstall
 
 > +          as <acronym>BIOS</acronym> and most of the motherboard or computer
 
 as the <acronym>BIOS</acronym>
 
 > +          manufactures have a website where the upgrades and upgrade information
 
 manufacturers
 
 > +          <quote>X Windows</quote> is can offend some people;
 
 ..</quote> can offend
 
 Sorry.
 
 Ceri

From: Tom Rhodes <darklogik@pittgoth.com>
To: Andrew McKay <andy@openirc.co.uk>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/34953: [PATCH] Handbook, cleaning prs
Date: Fri, 15 Feb 2002 10:21:13 -0500

 Andrew McKay wrote:
 
 > On Fri, 15 Feb 2002, Tom Rhodes wrote:
 > 
 > TR> Added some troubleshooting information to the install chapter, Andy I
 > TR> really liked your patch, but I added some to it and changed the
 > TR> wording a bit, hope you do not mind.
 > 
 > I do not mind at all.  Looks...beautiful ;)
 > 
 > 
 
 Thank you ;)
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 

From: Tom Rhodes <darklogik@pittgoth.com>
To: Ceri <setantae@submonkey.net>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/34953: [PATCH] Handbook, cleaning prs
Date: Fri, 15 Feb 2002 10:22:49 -0500

 Ceri wrote:
 
 > On Fri, Feb 15, 2002 at 12:45:40AM -0500, Tom Rhodes wrote:
 > 
 >> 	<step>
 >>-	  <title>FDISK Partition Editor</title>      
 >>-	  <para>Select <literal>da1</literal> to enter the <literal>FDISK
 >>-	      Partition Editor</literal>.  Type <userinput>A</userinput> to
 >>+	  <title>FDISK Partition Editor</title>
 >>+	  <para>Once inside FDISK, we can type <userinput>A</userinput> to
 >>
 > 
 > FDISK -> fdisk ?
 > 
 > 
 >>+	  <para>Next, you need to exit <application>Sysinstall</application>
 >>
 > 
 > Sysinstall -> sysinstall
 > 
 > 
 >>+          as <acronym>BIOS</acronym> and most of the motherboard or computer
 >>
 > 
 > as the <acronym>BIOS</acronym>
 > 
 >>+          manufactures have a website where the upgrades and upgrade information
 >>
 > 
 > manufacturers
 > 
 > 
 >>+          <quote>X Windows</quote> is can offend some people;
 >>
 > 
 > .</quote> can offend
 > 
 > Sorry.
 > 
 > Ceri
 > 
 > 
 > 
 
 Should I submit an update?
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/34953: [New Patch] provided
Date: Fri, 15 Feb 2002 11:05:38 -0500 (EST)

 This is an update to the handbook diff I submitted.  Thanks to Ceri
 for pointing my little mistake out near the bottom!  The majority
 of this is the same however ;)
 
 --Tom Rhodes
 
 
 diff -ru handbook.old/disks/chapter.sgml handbook/disks/chapter.sgml
 --- handbook.old/disks/chapter.sgml	Fri Feb 15 00:09:14 2002
 +++ handbook/disks/chapter.sgml	Fri Feb 15 00:34:05 2002
 @@ -193,18 +193,12 @@
  	    <command>/stand/sysinstall</command> and enter the
  	    <literal>Configure</literal> menu.  Within the
  	    <literal>FreeBSD Configuration Menu</literal>, scroll down and
 -	    select the <literal>Partition</literal> item.  Next you should
 -	    be presented with a list of hard drives installed in your
 -	    system.  If you do not see <literal>da1</literal> listed, you
 -	    need to recheck your physical installation and
 -	    <command>dmesg</command> output in the file
 -	    <filename>/var/run/dmesg.boot</filename>.</para>
 +	    select the <literal>Fdisk</literal> option.</para>
  	</step>
  
  	<step>
 -	  <title>FDISK Partition Editor</title>      
 -	  <para>Select <literal>da1</literal> to enter the <literal>FDISK
 -	      Partition Editor</literal>.  Type <userinput>A</userinput> to
 +	  <title>FDISK Partition Editor</title>
 +	  <para>Once inside FDISK, we can type <userinput>A</userinput> to
  	    use the entire disk for FreeBSD.  When asked if you want to
  	    <quote>remain cooperative with any future possible operating
  	      systems</quote>, answer <literal>YES</literal>.  Write the
 @@ -219,13 +213,14 @@
  	  <title>Disk Label Editor</title>
  	  <indexterm><primary>BSD partitions</primary></indexterm>
  
 -	  <para>Next, <application>Sysinstall</application> will
 +	  <para>Next, you need to exit <application>Sysinstall</application>
 +            and start it again.  Follow the directions above, although this
 +            time choose the <literal>Label</literal> option. This will
  	    enter the <literal>Disk Label Editor</literal>.  This
  	    is where you will create the traditional BSD partitions.  A
  	    disk can have up to eight partitions, labeled 
  	    <literal>a-h</literal>.
 -	    A few of
 -	    the partition labels have special uses.  The
 +	    A few of the partition labels have special uses.  The
  	    <literal>a</literal> partition is used for the root partition
  	    (<filename>/</filename>).  Thus only your system disk (e.g,
  	    the disk you boot from) should have an <literal>a</literal>
 diff -ru handbook.old/install/chapter.sgml handbook/install/chapter.sgml
 --- handbook.old/install/chapter.sgml	Fri Feb 15 00:09:15 2002
 +++ handbook/install/chapter.sgml	Fri Feb 15 00:28:05 2002
 @@ -4585,6 +4585,21 @@
          that case, the probes for the conflicting driver(s) should be
          disabled.</para>
  
 +      <note>
 +        <para>Some installation problems can be avoided or alleviated by
 +          by updating the firmware on various hardware components, most notably
 +          the motherboard.  The motherboard firmware may also be referred to
 +          as <acronym>BIOS</acronym> and most of the motherboard or computer
 +          manufactures have a website where the upgrades and upgrade information
 +          may be located.</para>
 +
 +        <para>Most manufacturers strongly advise against upgrading the motherboard
 +          <acronym>BIOS</acronym> unless there is a good reason for doing so, which
 +          could possibly be a critical update of sorts.  The upgrade process
 +          <emphasis>can</emphasis> go wrong, causing permanent damage to the
 +          <acronym>BIOS</acronym> chip.</para>
 +        </note>
 +
        <warning>
          <para>Do not disable any drivers you will need during the
            installation, such as your screen (<devicename>sc0</devicename>).
 diff -ru handbook.old/x11/chapter.sgml handbook/x11/chapter.sgml
 --- handbook.old/x11/chapter.sgml	Fri Feb 15 00:09:12 2002
 +++ handbook/x11/chapter.sgml	Fri Feb 15 00:40:31 2002
 @@ -59,9 +59,9 @@
  	letter in the Roman alphabet.</para>
  
        <para>X can be called <quote>X</quote>, <quote>X Window System</quote>,
 -	  <quote>X11</quote>, and other terms.  <quote>X Windows</quote> is
 -	  to be avoided wherever possible; see &man.X.1; for more
 -	  information.</para>
 +	  <quote>X11</quote>, and other terms.  Calling X11
 +          <quote>X Windows</quote> can offend some people;
 +          see &man.X.1; for a bit more insight on this.</para>
      </sect2>
  
      <sect2>
State-Changed-From-To: open->closed 
State-Changed-By: jim 
State-Changed-When: Fri Feb 15 12:47:04 PST 2002 
State-Changed-Why:  
Commited, thanks! 

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