Changeset abc3648 for chapter08

Timestamp:

12/10/2022 08:56:15 PM (17 months ago)

Author:

David Bryant <davidbryant@…>

Branches:

11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, bdubbs/gcc13, multilib, renodr/libudev-from-systemd, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/update-glibc

Children:

0a12f0a, 85064a1

Parents:

9729cec

Message:

Clarified directions in re: UEFI. Tweaked verbiage to make it more
idiomatic. Clarified meaning of configure options. Made several minor
revisions in program descriptions to improve readability. Added a
little explanatory material. Changed imperative mood to indicative
mood where that was appropriate.

File:

• chapter08/grub.xml (modified) (21 diffs)

chapter08/grub.xml

@@ -45 +45 @@
         If your system has UEFI support and you wish to boot LFS with UEFI,
         you can skip this package in LFS,
-        and install GRUB with UEFI support (and its dependencies) following
-        <ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink>
-        at the end of this chapter.
+        and install GRUB with UEFI support (and its dependencies) by following
+        the instructions on
+        <ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink>.
       </para>
     </note>
@@ -57 +57 @@
 
       <para>Don't try <quote>tuning</quote> this package with custom
-      compilation flags: this package is a bootloader, with low-level
-      operations in the source code which is likely to be broken by some
-      aggressive optimizations.</para>
+      compilation flags. This package is a bootloader. The low-level
+      operations in the source code may be broken by
+      aggressive optimization.</para>
     </warning>
 
@@ -76 +76 @@
         <listitem>
           <para>This allows the build to complete with warnings introduced
-          by more recent Flex versions.</para>
+          by more recent versions of Flex.</para>
         </listitem>
       </varlistentry>
@@ -84 +84 @@
         <listitem>
           <para>This option minimizes what is built by disabling a feature and
-          testing programs not needed for LFS.</para>
+          eliminating some test programs not needed for LFS.</para>
         </listitem>
       </varlistentry>
@@ -103 +103 @@
 mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userinput></screen>
 
-  <para>Using GRUB to make your LFS system bootable will be discussed in
+  <para>Making your LFS system bootable with GRUB will be discussed in
   <xref linkend="ch-bootable-grub"/>.</para>
 
@@ -139 +139 @@
         <term><command>grub-bios-setup</command></term>
         <listitem>
-          <para>Is a helper program for grub-install</para>
+          <para>Is a helper program for <command>grub-install</command></para>
           <indexterm zone="ch-system-grub grub-bios-setup">
             <primary sortas="b-grub-bios-setup">grub-bios-setup</primary>
@@ -149 +149 @@
         <term><command>grub-editenv</command></term>
         <listitem>
-          <para>A tool to edit the environment block</para>
+          <para>Is a tool to edit the environment block</para>
           <indexterm zone="ch-system-grub grub-editenv">
             <primary sortas="b-grub-editenv">grub-editenv</primary>
@@ -159 +159 @@
         <term><command>grub-file</command></term>
         <listitem>
-          <para>Checks if FILE is of the specified type.</para>
+          <para>Checks to see if the given file is of the specified type</para>
           <indexterm zone="ch-system-grub grub-file">
             <primary sortas="b-grub-file">grub-file</primary>
@@ -169 +169 @@
         <term><command>grub-fstest</command></term>
         <listitem>
-          <para>Tool to debug the filesystem driver</para>
+          <para>Is a tool to debug the filesystem driver</para>
           <indexterm zone="ch-system-grub grub-fstest">
             <primary sortas="b-grub-fstest">grub-fstest</primary>
@@ -179 +179 @@
         <term><command>grub-glue-efi</command></term>
         <listitem>
-          <para>Glue 32-bit and 64-bit binary into Apple universal one.</para>
+          <para>Glues 32-bit and 64-bit binaries into a single file (for Apple machines)</para>
           <indexterm zone="ch-system-grub grub-glue-efi">
             <primary sortas="b-grub-glue-efi">grub-glue-efi</primary>
@@ -189 +189 @@
         <term><command>grub-install</command></term>
         <listitem>
-          <para>Install GRUB on your drive</para>
+          <para>Installs GRUB on your drive</para>
           <indexterm zone="ch-system-grub grub-install">
             <primary sortas="b-grub-install">grub-install</primary>
@@ -199 +199 @@
         <term><command>grub-kbdcomp</command></term>
         <listitem>
-          <para>Script that converts an xkb layout into one recognized by
+          <para>Is a script that converts an xkb layout into one recognized by
           GRUB</para>
           <indexterm zone="ch-system-grub grub-kbdcomp">
@@ -210 +210 @@
         <term><command>grub-macbless</command></term>
         <listitem>
-          <para>Mac-style bless on HFS or HFS+ files</para>
+          <para>Is the Mac-style bless for HFS or HFS+ files (<command>bless</command>
+          is peculiar to Apple machiines; it makes a device bootable)</para>
           <indexterm zone="ch-system-grub grub-macbless">
             <primary sortas="b-grub-macbless">grub-macbless</primary>
@@ -231 +232 @@
         <term><command>grub-mkconfig</command></term>
         <listitem>
-          <para>Generate a grub config file</para>
+          <para>Generates a <filename>grub.cfg</filename> file</para>
           <indexterm zone="ch-system-grub grub-mkconfig">
             <primary sortas="b-grub-mkconfig">grub-mkconfig</primary>
@@ -241 +242 @@
         <term><command>grub-mkimage</command></term>
         <listitem>
-          <para>Make a bootable image of GRUB</para>
+          <para>Makes a bootable image of GRUB</para>
           <indexterm zone="ch-system-grub grub-mkimage">
             <primary sortas="b-grub-mkimage">grub-mkimage</primary>
@@ -292 +293 @@
         <term><command>grub-mkrescue</command></term>
         <listitem>
-          <para>Make a bootable image of GRUB suitable for a floppy disk or CDROM/DVD</para>
+          <para>Makes a bootable image of GRUB suitable for a floppy disk,
+          CDROM/DVD, or a USB drive</para>
           <indexterm zone="ch-system-grub grub-mkrescue">
             <primary sortas="b-grub-mkrescue">grub-mkrescue</primary>
@@ -312 +314 @@
         <term><command>grub-ofpathname</command></term>
         <listitem>
-          <para>Is a helper program that prints the path of a GRUB device</para>
+          <para>Is a helper program that prints the path to a GRUB device</para>
           <indexterm zone="ch-system-grub grub-ofpathname">
             <primary sortas="b-grub-ofpathname">grub-ofpathname</primary>
@@ -322 +324 @@
         <term><command>grub-probe</command></term>
         <listitem>
-          <para>Probe device information for a given path or device</para>
+          <para>Probes device information for a given path or device</para>
           <indexterm zone="ch-system-grub grub-probe">
             <primary sortas="b-grub-probe">grub-probe</primary>
@@ -342 +344 @@
         <term><command>grub-render-label</command></term>
         <listitem>
-          <para>Render Apple .disk_label for Apple Macs</para>
+          <para>Renders Apple .disk_label for Apple Macs</para>
           <indexterm zone="ch-system-grub grub-render-label">
             <primary sortas="b-grub-render-label">grub-render-label</primary>
@@ -352 +354 @@
         <term><command>grub-script-check</command></term>
         <listitem>
-          <para>Checks GRUB configuration script for syntax errors</para>
+          <para>Checks the GRUB configuration script for syntax errors</para>
           <indexterm zone="ch-system-grub grub-script-check">
             <primary sortas="b-grub-script-check">grub-script-check</primary>
@@ -382 +384 @@
         <term><command>grub-syslinux2cfg</command></term>
         <listitem>
-          <para>Transform a syslinux config file into grub.cfg format</para>
+          <para>Transforms a syslinux config file into grub.cfg format</para>
           <indexterm zone="ch-system-grub grub-syslinux2cfg">
             <primary sortas="b-grub-syslinux2cfg">grub-syslinux2cfg</primary>