Patched clumsy verbiage. Added two items (hardlink, lsfd) to the list

of installed programs. Added (link to setarch) to the five items that
link to setarch. Corrected erroneous description of swapoff. Clarified
some of the "short descriptions". Changed the imperative mood to the
indicative mood, and added an "s" to a couple of possessive nouns.

1 files changed, 52 insertions, 29 deletions

diff --git a/chapter08/util-linux.xml b/chapter08/util-linux.xml
index 7648d2a7f..221743d3d 100644
--- a/chapter08/util-linux.xml
+++ b/chapter08/util-linux.xml
@@ -77,7 +77,7 @@
             --docdir=/usr/share/doc/util-linux-&util-linux-version;</userinput></screen>
 
     <para>The --disable and --without options prevent warnings about
-    building components that require packages not in LFS or are
+    building components that either require packages not in LFS, or are
     inconsistent with programs installed by other packages.</para>
 
     <para>Compile the package:</para>
@@ -92,7 +92,7 @@
     be available in the currently running system and must be built as a
     module.  Building it into the kernel will prevent booting.  For complete
     coverage, other BLFS packages must be installed.  If desired, this test can
-    be run after rebooting into the completed LFS system and running:</para>
+    be run by booting into the completed LFS system and running:</para>
 
 <screen role="nodump"><userinput>bash tests/run.sh --srcdir=$PWD --builddir=$PWD</userinput></screen>
     </warning>
@@ -125,16 +125,17 @@ su tester -c "make -k check"</userinput></screen>
         <seg>addpart, agetty, blkdiscard, blkid, blkzone, blockdev, cal, cfdisk, chcpu,
         chmem, choom, chrt, col, colcrt, colrm, column, ctrlaltdel, delpart, dmesg,
         eject, fallocate, fdisk, fincore, findfs, findmnt, flock, fsck,
-        fsck.cramfs, fsck.minix, fsfreeze, fstrim, getopt, hexdump, hwclock,
-        i386, ionice, ipcmk, ipcrm, ipcs, irqtop, isosize, kill, last, lastb (link to
-        last), ldattach, linux32, linux64, logger, look, losetup, lsblk, lscpu,
-        lsipc, lsirq, lslocks, lslogins, lsmem, lsns, mcookie, mesg, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap,
+        fsck.cramfs, fsck.minix, fsfreeze, fstrim, getopt, hardlink, hexdump, hwclock,
+        i386 (link to setarch), ionice, ipcmk, ipcrm, ipcs, irqtop, isosize, kill, last, 
+        lastb (link to last), ldattach, linux32 (link to setarch), linux64 (link to setarch),
+        logger, look, losetup, lsblk, lscpu, lsipc, lsirq, lsfd, lslocks, lslogins,
+        lsmem, lsns, mcookie, mesg, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap,
         more, mount, mountpoint, namei, nsenter, partx, pivot_root, prlimit,
         readprofile, rename, renice, resizepart, rev, rfkill, rtcwake, script,
         scriptlive, scriptreplay, setarch, setsid, setterm, sfdisk, sulogin, swaplabel,
-        swapoff (link to swapon), swapon, switch_root, taskset, uclampset, ul,
-        umount, uname26, unshare, utmpdump, uuidd, uuidgen, uuidparse, wall, wdctl, whereis,
-        wipefs, x86_64, and zramctl</seg>
+        swapoff, swapon, switch_root, taskset, uclampset, ul,
+        umount, uname26 (link to setarch), unshare, utmpdump, uuidd, uuidgen, uuidparse,
+        wall, wdctl, whereis, wipefs, x86_64 (link to setarch), and zramctl</seg>
         <seg>libblkid.so, libfdisk.so, libmount.so,
         libsmartcols.so, and libuuid.so</seg>
         <seg>/usr/include/blkid,
@@ -197,7 +198,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="blkzone">
         <term><command>blkzone</command></term>
         <listitem>
-          <para>Runs zone command on the given block device</para>
+          <para>Is used to manage zoned storage block devices</para>
           <indexterm zone="ch-system-util-linux blkzone">
             <primary sortas="b-blkzone">blkzone</primary>
           </indexterm>
@@ -258,7 +259,8 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="choom">
         <term><command>choom</command></term>
         <listitem>
-          <para>Displays and adjusts OOM-killer score</para>
+          <para>Displays and adjusts OOM-killer scores, used to determine
+          which process to kill first when Linux is Out Of Memory</para>
           <indexterm zone="ch-system-util-linux choom">
             <primary sortas="b-choom">choom</primary>
           </indexterm>
@@ -390,7 +392,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="findfs">
         <term><command>findfs</command></term>
         <listitem>
-          <para>Finds a file system by label or Universally Unique Identifier
+          <para>Finds a file system, either by label or Universally Unique Identifier
           (UUID)</para>
           <indexterm zone="ch-system-util-linux findfs">
             <primary sortas="b-findfs">findfs</primary>
@@ -402,7 +404,7 @@ su tester -c "make -k check"</userinput></screen>
         <term><command>findmnt</command></term>
         <listitem>
           <para>Is a command line interface to the libmount library
-          for work with mountinfo, fstab and mtab files</para>
+          for working with mountinfo, fstab and mtab files</para>
           <indexterm zone="ch-system-util-linux findmnt">
             <primary sortas="b-findmnt">findmnt</primary>
           </indexterm>
@@ -482,12 +484,22 @@ su tester -c "make -k check"</userinput></screen>
           </indexterm>
         </listitem>
       </varlistentry>
+      
+      <varlistentry id="hardlink">
+        <term><command>hardlink</command></term>
+        <listitem>
+          <para>Consolidates duplicate files by creating hard links</para>
+          <indexterm zone="ch-system-util-linux hardlink">
+            <primary sortas="b-hardlink">hardlink</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
 
       <varlistentry id="hexdump">
         <term><command>hexdump</command></term>
         <listitem>
-          <para>Dumps the given file in hexadecimal or in another given
-          format</para>
+          <para>Dumps the given file in hexadecimal, decimal, octal,
+          or ascii</para>
           <indexterm zone="ch-system-util-linux hexdump">
             <primary sortas="b-hexdump">hexdump</primary>
           </indexterm>
@@ -690,6 +702,16 @@ su tester -c "make -k check"</userinput></screen>
           </indexterm>
         </listitem>
       </varlistentry>
+      
+      <varlistentry id="lsfd">
+        <term><command>lsfd</command></term>
+        <listitem>
+          <para>Displays information about open files; replaces <command>lsof</command></para>
+          <indexterm zone="ch-system-util-linux lsfd">
+            <primary sortas="b-lsfd">lsfd</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
 
       <varlistentry id="lsipc">
         <term><command>lsipc</command></term>
@@ -861,7 +883,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="namei">
         <term><command>namei</command></term>
         <listitem>
-          <para>Shows the symbolic links in the given pathnames</para>
+          <para>Shows the symbolic links in the given paths</para>
           <indexterm zone="ch-system-util-linux namei">
             <primary sortas="b-namei">namei</primary>
           </indexterm>
@@ -903,7 +925,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="prlimit">
         <term><command>prlimit</command></term>
         <listitem>
-          <para>Get and set a process' resource limits</para>
+          <para>Gets and sets a process's resource limits</para>
           <indexterm zone="ch-system-util-linux prlimit">
             <primary sortas="b-prlimit">prlimit</primary>
           </indexterm>
@@ -974,7 +996,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="rtcwake">
         <term><command>rtcwake</command></term>
         <listitem>
-          <para>Used to enter a system sleep state until specified wakeup
+          <para>Used to enter a system sleep state until the specified wakeup
           time</para>
           <indexterm zone="ch-system-util-linux rtcwake">
             <primary sortas="b-rtcwake">rtcwake</primary>
@@ -995,7 +1017,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="scriptlive">
         <term><command>scriptlive</command></term>
         <listitem>
-          <para>Re-run session typescripts using timing information</para>
+          <para>Re-runs session typescripts using timing information</para>
           <indexterm zone="ch-system-util-linux scriptlive">
             <primary sortas="b-scriptlive">scriptlive</primary>
           </indexterm>
@@ -1015,7 +1037,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="setarch">
         <term><command>setarch</command></term>
         <listitem>
-          <para>Changes reported architecture in a new program environment and
+          <para>Changes reported architecture in a new program environment, and
           sets personality flags</para>
           <indexterm zone="ch-system-util-linux setarch">
             <primary sortas="b-setarch">setarch</primary>
@@ -1068,7 +1090,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="swaplabel">
         <term><command>swaplabel</command></term>
         <listitem>
-          <para>Allows to change swaparea UUID and label</para>
+          <para>Makes changes to the swap area's UUID and label</para>
           <indexterm zone="ch-system-util-linux swaplabel">
             <primary sortas="b-swaplabel">swaplabel</primary>
           </indexterm>
@@ -1088,7 +1110,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="swapon">
         <term><command>swapon</command></term>
         <listitem>
-          <para>Enables devices and files for paging and swapping and
+          <para>Enables devices and files for paging and swapping, and
           lists the devices and files currently in use</para>
           <indexterm zone="ch-system-util-linux swapon">
             <primary sortas="b-swapon">swapon</primary>
@@ -1109,7 +1131,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="taskset">
         <term><command>taskset</command></term>
         <listitem>
-          <para>Retrieves or sets a process' CPU affinity</para>
+          <para>Retrieves or sets a process's CPU affinity</para>
           <indexterm zone="ch-system-util-linux taskset">
             <primary sortas="b-taskset">taskset</primary>
           </indexterm>
@@ -1119,7 +1141,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="uclampset">
         <term><command>uclampset</command></term>
         <listitem>
-          <para>Manipulate the utilization clamping attributes of the
+          <para>Manipulates the utilization clamping attributes of the
           system or a process</para>
           <indexterm zone="ch-system-util-linux uclampset">
             <primary sortas="b-uclampset">uclampset</primary>
@@ -1171,7 +1193,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="utmpdump">
         <term><command>utmpdump</command></term>
         <listitem>
-          <para>Displays the content of the given login file in a more
+          <para>Displays the content of the given login file in a
           user-friendly format</para>
           <indexterm zone="ch-system-util-linux utmpdump">
             <primary sortas="b-utmpdump">utmpdump</primary>
@@ -1193,9 +1215,10 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="uuidgen">
         <term><command>uuidgen</command></term>
         <listitem>
-          <para>Creates new UUIDs. Each new UUID can reasonably be considered
+          <para>Creates new UUIDs. Each new UUID is a random number likely to be
           unique among all UUIDs created, on the local system and on other
-          systems, in the past and in the future</para>
+          systems, in the past and in the future, with extremely high
+          probability (~340 trillion trillion trillion unique UUIDs are possible)</para>
           <indexterm zone="ch-system-util-linux uuidgen">
             <primary sortas="b-uuidgen">uuidgen</primary>
           </indexterm>
@@ -1205,7 +1228,7 @@ su tester -c "make -k check"</userinput></screen>
       <varlistentry id="uuidparse">
         <term><command>uuidparse</command></term>
         <listitem>
-          <para>An utility to parse unique identifiers</para>
+          <para>A utility to parse unique identifiers</para>
           <indexterm zone="ch-system-util-linux uuidparse">
             <primary sortas="b-uuidparse">uuidparse</primary>
           </indexterm>
@@ -1237,7 +1260,7 @@ su tester -c "make -k check"</userinput></screen>
         <term><command>whereis</command></term>
         <listitem>
           <para>Reports the location of the binary, source, and man page
-          for the given command</para>
+          files for the given command</para>
           <indexterm zone="ch-system-util-linux whereis">
             <primary sortas="b-whereis">whereis</primary>
           </indexterm>