Changing the style of the command descriptions in appendix A.

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

1 files changed, 27 insertions, 39 deletions

diff --git a/appendixa/procps-desc.xml b/appendixa/procps-desc.xml
index 8c307e151..32501415f 100644
--- a/appendixa/procps-desc.xml
+++ b/appendixa/procps-desc.xml
@@ -6,62 +6,50 @@
 
 <sect3><title>Program file descriptions</title>
 
-<sect4><title>free</title>
-<para>free displays the total amount of free and used physical and swap memory 
-in the system, as well as the shared memory and buffers used by the 
-kernel.</para></sect4>
+<para><command>free</command> reports the amount of free and used memory
+in the system, both physical and swap memory.</para>
 
-<sect4><title>kill</title>
-<para>kills sends signals to processes.</para></sect4>
+<para><command>kill</command> is used to send signals to processes.</para>
 
-<sect4><title>oldps and ps</title>
-<para>ps gives a snapshot of the current processes.</para></sect4>
+<para><command>ps</command> gives a snapshot of the current processes.</para>
 
-<sect4><title>pgrep</title>
-<para>pgrep looks up processes based on name and other attributes.</para></sect4>
+<para><command>pgrep</command> looks up processes based on their name
+and other attributes.</para>
 
-<sect4><title>pkill</title>
-<para>pkill signals processes based on name and other attributes.</para></sect4>
+<para><command>pkill</command> signals processes based on their name
+and other attributes.</para>
 
-<sect4><title>skill</title>
-<para>skill sends signals to process matching a criteria.</para></sect4>
+<para><command>skill</command> sends signals to processes matching the
+given criteria.</para>
 
-<sect4><title>snice</title>
-<para>snice changes the scheduling priority for process matching a 
-criteria.</para></sect4>
+<para><command>snice</command> changes the scheduling priority of processes
+matching the given criteria.</para>
 
-<sect4><title>sysctl</title>
-<para>sysctl modifies kernel parameters at runtime.</para></sect4>
+<para><command>sysctl</command> modifies kernel parameters at run time.</para>
 
-<sect4><title>tload</title>
-<para>tload prints a graph of the current system load average to the 
-specified tty or, if none is specified, the tty of the tload 
-process.</para></sect4>
+<para><command>tload</command> prints a graph of the current system load
+average.</para>
 
-<sect4><title>top</title>
-<para>top provides an ongoing look at processor activity 
-in real time.</para></sect4>
+<para><command>top</command> displays the top CPU processes. It provides
+an ongoing look at processor activity in real time.</para>
 
-<sect4><title>vmstat</title>
-<para>vmstat reports information about processes, memory, paging, block IO, 
-traps and cpu activity.</para></sect4>
+<para><command>vmstat</command> reports virtual memory statistics, giving
+information about processes, memory, paging, block IO, traps, and CPU
+activity.</para>
 
-<sect4><title>w</title>
-<para>w displays information about the users, and their processes,
-currently on the machine.</para></sect4>
+<para><command>w</command> shows which users are currently logged on,
+where and since when.</para>
 
-<sect4><title>watch</title>
-<para>watch runs command repeatedly, displaying its output (the first 
-screen full).</para></sect4>
+<para><command>watch</command> runs a given command repeatedly,
+displaying the first screenful of its output. This allows you to watch the
+output change over time.</para>
 
 </sect3>
 
 <sect3><title>Library file descriptions</title>
 
-<sect4><title>libproc</title>
-<para>libproc is the library against which most of the programs in this
-set are linked to save disk space by implementing common functions only
-once.</para></sect4>
+<para><command>libproc</command> contains the functions used by most
+programs in this package.</para>
 
 </sect3>