Adapting the style of the Grub configuration section.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2954 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

chapter08/grub.xml

@@ -8,67 +8,76 @@ we need to ensure we can boot it.  To do this, we will run the
 
 <para><screen><userinput>grub</userinput></screen></para>
 
-<para>Grub uses its own naming structure for drives, in the form of (hdn,m),
-where n is the hard drive number, and m is the partition number, both of which
-start from zero.  So, partition hda1 would be (hd0,0) to Grub, and hdb2 would
-be (hd1,1).  Also, Grub doesn't pay attention to CD-ROM drives at all, so if,
-for example, you have a CD on hdb, and a second hard drive on hdc, partitions
-on that second hard drive would still be (hd1,m).</para>
+<para>Grub uses its own naming structure for drives and partitions, in the form
+of (hdn,m), where <emphasis>n</emphasis> is the hard drive number, and
+<emphasis>m</emphasis> the partition number, both starting from zero. This
+means, for instance, that partition <filename>hda1</filename> is (hd0,0) to
+Grub, and <filename>hdb2</filename> is (hd1,1). In contrast to Linux, Grub
+doesn't consider CD-ROM drives to be hard drives, so if you have a CD on
+<filename>hdb</filename>, for example, and a second hard drive on
+<filename>hdc</filename>, that second hard drive would still be (hd1).</para>
 
-<para>So, using the information above, select the appropriate designator for
-your root partition.  For the purposes of this, we will assume (hd0,3) for
-your root partition.  First, we tell grub where to find its files:</para>
+<para>Using the above information, determine the appropriate designator for
+your root partition. For the folowing example, we'll assume your root partition
+is <filename>hda4</filename>.</para>
 
-<para><screen><userinput>root (hd0,3)
-setup (hd0)
-quit</userinput></screen></para>
+<para>First, tell Grub where to search for its <filename>stage{1,2}</filename>
+files -- you can use Tab everywhere to make Grub show the alternatives:</para>
 
-<para>This tells Grub to look for its files on hda4 (hd0,3), and install itself
-into the MBR (Master Boot Record) of hda.</para>
+<para><screen><userinput>root (hd0,3)</userinput></screen></para>
 
-<para>Also, we need to create the <filename>menu.lst</filename> file, which
-Grub uses to designate its boot menu:</para>
+<para>Then tell it to install itself into the MBR (Master Boot Record) of
+<filename>hda</filename>:</para>
 
-<para><screen><userinput>cat &gt; /boot/grub/menu.lst &lt;&lt; "EOF"
+<para><screen><userinput>setup (hd0)</userinput></screen></para>
+
+<para>If all is well, Grub will have reported finding its files in
+<filename>/boot/grub</filename>. That's all there was to it:</para>
+
+<para><screen><userinput>quit</userinput></screen></para>
+
+<para>Now we need to create the <filename>menu.lst</filename> file, which
+defines Grub's boot menu:</para>
+
+<para><screen><userinput>cat &gt; /boot/grub/menu.lst &lt;&lt; "EOF"</userinput>
 # Begin /boot/grub/menu.lst
 
-# Default to first menu entry
+# By default boot the first menu entry.
 default 0
 
-# Allow 30 seconds before booting default
+# Allow 30 seconds before booting the default.
 timeout 30
 
-# Use prettier colors
+# Use prettier colors.
 color green/black light-green/black
 
-# Default Entry for LFS
+# The first entry is for LFS.
 title LFS 5.0
 root (hd0,3)
 kernel /boot/lfskernel root=/dev/hda4 ro
-EOF</userinput></screen></para>
+<userinput>EOF</userinput></screen></para>
 
-<para>You might also want to add in an entry for your host distribution.  It
-might look similar to this:</para>
+<para>You may want to add an entry for your host distribution.  It might look
+like this:</para>
 
-<para><screen><userinput>cat &gt;&gt; /boot/grub/menu.lst &lt;&lt; "EOF"
-# Redhat Linux
-title Redhat
+<para><screen><userinput>cat &gt;&gt; /boot/grub/menu.lst &lt;&lt; "EOF"</userinput>
+title Red Hat
 root (hd0,2)
 kernel /boot/kernel-2.4.20 root=/dev/hda3 ro
 initrd /boot/initrd-2.4.20
-EOF</userinput></screen></para>
+<userinput>EOF</userinput></screen></para>
 
 <para>Also, if you happen to dual-boot Windows, the following entry should
 allow booting it:</para>
 
-<para><screen><userinput>cat &gt;&gt; /boot/grub/menu.lst &lt;&lt; "EOF"
-# Windows
+<para><screen><userinput>cat &gt;&gt; /boot/grub/menu.lst &lt;&lt; "EOF"</userinput>
 title Windows
 rootnoverify (hd0,0)
 chainloader +1
-EOF</userinput></screen></para>
+<userinput>EOF</userinput></screen></para>
 
-<para>You can find more information regarding Grub on its website, located at:
+<para>If <userinput>info grub</userinput> doesn't tell you all you want to
+know, you can find more information regarding Grub on its website, located at:
 <ulink url="http://www.gnu.org/software/grub"/>.</para>
 
 </sect1>