install-guide fedora-install-guide-bootloader-en.xml,1.7,1.8

Paul W. Frields (pfrields) fedora-docs-commits at redhat.com
Sat May 14 21:49:46 UTC 2005


Author: pfrields

Update of /cvs/docs/install-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv26991

Modified Files:
	fedora-install-guide-bootloader-en.xml 
Log Message:
1.  More style edits
2.  Made section on GRUB passwords more procedure-oriented
3.  Reset id attributes to reflect DocGuide standards (2.1)



Index: fedora-install-guide-bootloader-en.xml
===================================================================
RCS file: /cvs/docs/install-guide/fedora-install-guide-bootloader-en.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- fedora-install-guide-bootloader-en.xml	14 May 2005 15:22:52 -0000	1.7
+++ fedora-install-guide-bootloader-en.xml	14 May 2005 21:49:44 -0000	1.8
@@ -25,10 +25,9 @@
   </warning>
 
   <para>
-    <xref linkend="ch-bootloader-config-fig"/> shows the boot loader
-    configuration choices.
+    The following screen displays boot loader configuration options.
   </para>
-  <figure id="ch-bootloader-config-fig">
+  <figure id="fig-bootloader-config">
     <title>
       Boot Loader Configuration Screen
     </title>
@@ -45,10 +44,8 @@
     </mediaobject>
   </figure>
 
-  <section id="ch-bootloader-config-change">
-    <title>
-      Keeping Your Existing Boot Loader Settings
-    </title>
+  <section id="sn-bootloader-config-change">
+    <title>Keeping Your Existing Boot Loader Settings</title>
     <para>
       By default, the installation program installs GRUB in the
       <firstterm>master boot record</firstterm>, <indexterm>
@@ -56,11 +53,11 @@
       </indexterm> or <abbrev>MBR</abbrev>, of the device for the root
       file system.  To change or decline installation of a new boot
       loader, select the <guibutton>Change boot loader</guibutton>
-      button.  The pop-up shown in
-      <xref linkend="ch-bootloader-change-fig"/> allows you to avoid
+      button.  The dialog shown in
+      <xref linkend="fig-bootloader-change"/> allows you to avoid
       installing or changing your existing boot loader settings.
     </para>
-    <figure id="ch-bootloader-change-fig">
+    <figure id="fig-bootloader-change">
       <title>Change Boot Loader</title>
       <mediaobject>
         <imageobject>
@@ -76,74 +73,72 @@
     </figure>
     <note>
       <para>
-        If you decline to install any boot loader, you will not be able
-	to boot Linux after the installation unless you choose to
-	generate a startup disk.  Refer to 
+        If you do not install any boot loader, you will not be able to
+	boot Linux after the installation unless you generate a startup
+	disk. <!-- FIXME: Add reference to startup disk elsewhere in the
+	IG. - PWF. -->
       </para>
     </note>
   </section>
 
-  <section id="ch-bootloader-others">
+  <section id="sn-bootloader-others">
     <title>
       Booting Additional Operating Systems
     </title>
     <para>
       If you have other operating systems already installed, &FED;
       attempts to automatically detect and configure
-      <application>GRUB</application> so that any installed
-      <abbrev>OS</abbrev> can be booted.  You can also manually configure
-      any additional operating systems if
-      <application>GRUB</application> does not detect them.  To the right
-      of the partition display there are three buttons that allow you to
-      add, remove, or change the detected operating system settings.
-    </para>
-    <glosslist>
-      <glossentry>
-        <glossterm>
+      <application>GRUB</application> to boot them.  You may manually
+      configure any additional operating systems if
+      <application>GRUB</application> does not detect them.  To
+      add, remove, or change the detected operating system settings,
+      use the options provided.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term>
           <guibutton>Add</guibutton>
-        </glossterm>
-        <glossdef>
+        </term>
+        <listitem>
           <para>
-              Pressing the <guibutton>Add</guibutton> button displays
-	    the pop-up shown in <xref
-	      linkend="ch-bootloader-others-popup-fig"/>.
+	    Press the <guibutton>Add</guibutton> button to include an
+	    additional operating system in GRUB.  &FED; displays the
+	    dialog shown in <xref
+	      linkend="fig-bootloader-others-popup"/>.
 	  </para>
           <para>
-	    You must know the disk partition holding the bootable
-	    operating system.  Select the disk partition holding the
-	    bootable operating system from the drop-down list and give
-	    the entry a label.  The label is shown at boot-time when
-	    <application>GRUB</application> presents its boot menu.
+	    Select the disk partition which contains the bootable
+	    operating system from the drop-down list and give the entry
+	    a label.  <application>GRUB</application> displays this
+	    label in its boot menu.
 	  </para>
-        </glossdef>
-      </glossentry>
-      <glossentry>
-        <glossterm>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
           <guibutton>Edit</guibutton>
-        </glossterm>
-        <glossdef>
-          <para>
-	    You can change an entry shown in the partition list by
-	    clicking on the item with the mouse and then pressing the
-	    <guibutton>Edit</guibutton> button.
+        </term>
+	<listitem>
+	  <para>
+	    To change an entry in the GRUB boot menu, select the entry
+	    and then select <guibutton>Edit</guibutton>.
 	  </para>
-        </glossdef>
-      </glossentry>
-      <glossentry>
-        <glossterm>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
           <guibutton>Delete</guibutton>
-        </glossterm>
-        <glossdef>
+        </term>
+        <listitem>
           <para>
-	    If you want to remove an entry from the partition list, just
-	    click it with the mouse and then press the
-	    <guibutton>Delete</guibutton> button.
+	    To remove an entry from the GRUB boot menu, select the entry
+	    and then select <guibutton>Delete</guibutton>.
 	  </para>
-        </glossdef>
-      </glossentry>
-    </glosslist>
-    <figure id="ch-bootloader-others-popup-fig">
-      <title>Adding Other Operating Systems To The Boot Menu</title>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <figure id="fig-bootloader-others-popup">
+      <title>Adding Operating Systems to the Boot Menu</title>
       <mediaobject>
         <imageobject>
           <imagedata align="center" fileref="figs/bootloader-others.eps" format="EPS"/>
@@ -158,48 +153,37 @@
     </figure>
   </section>
 
-  <section id="ch-bootloader-password">
+  <section id="sn-bootloader-password">
     <title>
-      Setting A Boot loader Password
+      Setting a Boot Loader Password
     </title>
     <para>
-      A useful <application>GRUB</application> feature is that it can
-      browse disk files itself on many file system layouts, not relying
-      on any active <abbrev>OS</abbrev>.  An operator can interrupt the
-      booting sequence to choose a different image file to boot, or to
-      change the command line arguments passed to the kernel.  A system
-      administrator can use the features to recover a system that will
-      not boot.
-    </para>
-    <para>
-      Alas, allowing whom ever happens to be near the system console to
-      type arbitrary commands or to change system parameters during the
-      boot sequence can be a security issue.
-      <application>GRUB</application> can be configured to require that
-      a password be typed before the start parameters can be changed.
-      Any operator with console access can boot the system but only if
-      the correct password is given can the boot settings be changed.
-    </para>
-    <para>
-      You do not have to set a <application>GRUB</application> password.
-      If you have trusted operators, or a physically secured system with
-      controlled console access, you probably do not need a boot
-      password.  Likewise if you have a single-user system and you do not
-      worry about passers-by rebooting your system and fiddling with it,
-      you can probably dispense with a boot password.
+      <application>GRUB</application> reads many file systems without
+      the help of an operating system.  An operator can interrupt the
+      booting sequence to choose a different operating system to boot,
+      change boot options, or recover from a system error.  These
+      functions, however, may introduce serious security risks in some
+      environments.  You can add a password to
+      <application>GRUB</application> so that the operator must enter
+      the password to interrupt the normal boot sequence.
     </para>
+    <tip>
+      <title>GRUB Passwords Not Required</title>
+      <para>
+	You may not require a <application>GRUB</application> password
+	if your system only has trusted operators, or is physically
+	secured with controlled console access.
+      </para>
+    </tip>
     <para>
-      If you decide to use a boot password, mark the checkbox beside the
-      <guibutton>Use a boot loader password</guibutton> legend.  The
-      <guibutton>Change password</guibutton> button will become
-      un-grayed and selectable.  Press the <guibutton>Change
-	password</guibutton> button to display the pop-up shown in
-      <xref
-	linkend="ch-bootloader-password-fig"/>.  Carefully type in your
-      desired password and then confirm its correctness by typing it
-      again in the space provided.
+      To set a boot password, select the <guibutton>Use a boot loader
+	password</guibutton> checkbox.  The <guibutton>Change
+	password</guibutton> button will become active.  Select
+      <guibutton>Change password</guibutton> to display the dialog
+      below.  Type the desired password, and then confirm it by typing
+      it again in the spaces provided.
     </para>
-    <figure id="ch-bootloader-password-fig">
+    <figure id="fig-bootloader-password">
       <title>Entering A Boot Password</title>
       <mediaobject>
         <imageobject>
@@ -213,48 +197,59 @@
         </textobject>
       </mediaobject>
     </figure>
-    <warning>
+    <tip>
+      <title>Choose a Good Password</title>
       <para>
         Choose a password that is easy for you to remember but hard for
-	others to guess.  The password is stored in encrypted form and
-	<emphasis>cannot</emphasis> be recovered.
+	others to guess.
       </para>
+    </tip>
+    <warning>
+      <title>Forgotten <application>GRUB</application> Passwords</title>
       <para>
-        If you forget the boot password, "Don't Panic!".
-	All you need do is boot the system normally and then change the
-	password entry in the <filename>/etc/grub.conf</filename> file.
+        <application>GRUB</application> stores the password in encrypted
+	form, so it <emphasis>cannot</emphasis> be read or recovered. If
+	you forget the boot password, boot the system normally and then
+	change the password entry in the
+	<filename>/boot/grub/grub.conf</filename> file. If you cannot
+	boot, you may be able to use the "rescue" mode on the first &FC;
+	installation disc to reset the GRUB password.
       </para>
     </warning>
   </section>
 
-  <section id="ch-bootloader-advanced">
+  <section id="sn-bootloader-advanced">
     <title>
       Advanced Boot loader Options
     </title>
     <para>
       The default boot options are adequate for most situations.  The
-      <application>GRUB</application> boot loader will be stored in the
-      <abbrev>MBR</abbrev>, overwriting any existing boot loader.
+      installation program writes the <application>GRUB</application>
+      boot loader in the
+      <indexterm>
+	<primary>master boot record</primary>
+      </indexterm> master boot record (<abbrev>MBR</abbrev>),
+      overwriting any existing boot loader.
     </para>
     <para>
-      If you want to keep your current boot loader in the
-      <abbrev>MBR</abbrev>, you must use the advanced settings to place
-      <application>GRUB</application> in the first sector of the
-      partition holding the Linux root file system.
+      Tto keep your current boot loader in the <abbrev>MBR</abbrev>, use
+      the advanced settings to place <application>GRUB</application> in
+      the first sector of the partition holding the Linux root file
+      system.
     </para>
     <para>
       You may also need the advanced options if your
-      <abbrev>BIOS</abbrev> has numbered your disk devices differently
-      than Linux expects.  On some systems, Linux may not configure the
+      <abbrev>BIOS</abbrev> enumerates your disk devices differently
+      than &FED; expects.  On a few systems, &FED; may not configure the
       disk drive geometry for large disks correctly because of a broken
-      <abbrev>BIOS</abbrev>.  As a work around, mark the <guibutton>Force
-	LBA32</guibutton> checkbox.
+      <abbrev>BIOS</abbrev>.  To work around this problem, mark the
+      <guibutton>Force LBA32</guibutton> checkbox.
     </para>
     <para>
       The Linux kernel usually auto-detects its environment correctly,
-      and no additional kernel parameters are needed.  However, it is
-      possible to provide any needed kernel parameter using the advanced
-      boot loader options.
+      and no additional kernel parameters are needed.  You may provide
+      any needed kernel parameter, however, using the advanced boot
+      loader options.
     </para>
     <note>
       <para>
@@ -265,20 +260,19 @@
       </para>
     </note>
     <para>
-      If you need to alter any of these settings, mark the
-      <guibutton>Configure advanced boot loader options</guibutton>
-      checkbox.  Then, when you press <guibutton>Next</guibutton>, the
-      menu shown in <xref linkend="ch-bootloader-advanced-fig"/> will
-      appear.
+      To alter any of these settings, mark the <guibutton>Configure
+	advanced boot loader options</guibutton> checkbox.  Select
+      <guibutton>Next</guibutton> and the menu shown in <xref
+	linkend="fig-bootloader-advanced"/> appears.
     </para>
     <note>
       <para>
-        The following advanced boot options menu will be displayed
-	<emphasis>only</emphasis> if the advanced configuration
-	checkbox, just described, has been selected.
+        &FED; displays the following advanced boot options menu
+	<emphasis>only</emphasis> if the advanced configuration checkbox
+	described above has been selected.
       </para>
     </note>
-    <figure id="ch-bootloader-advanced-fig">
+    <figure id="fig-bootloader-advanced">
       <title>Advanced Boot Options</title>
       <mediaobject>
         <imageobject>
@@ -288,8 +282,7 @@
           <imagedata align="center" fileref="figs/bootloader-advanced.png" format="PNG"/>
         </imageobject>
         <textobject>
-          <phrase>Menu displayed if advanced boot settings are
-	    desired</phrase>
+          <phrase>Advanced boot settings menu</phrase>
         </textobject>
       </mediaobject>
     </figure>




More information about the Fedora-docs-commits mailing list