Bug 34953

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>

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

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

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

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>

Comment 6 Jim Mock 2002-02-15 20:47:04 UTC

State Changed
From-To: open->closed

Commited, thanks!