[Bug 190] reorganise and sync descriptions

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

1 files changed, 49 insertions, 31 deletions

diff --git a/appendixa/procps-desc.xml b/appendixa/procps-desc.xml
index c330c8ab7..f4daaf1e0 100644
--- a/appendixa/procps-desc.xml
+++ b/appendixa/procps-desc.xml
@@ -1,60 +1,78 @@
-<sect2>
-<title>Contents</title>
+<sect2><title>Contents of procps-&procps-contversion;</title>
 
-<para>The Procps package contains the free, kill, oldps, ps, skill, snice,
-sysctl, tload, top, uptime, vmstat, w and watch programs.</para>
+<sect3><title>Program Files</title>
+<para>free, kill, oldps, pgrep, pkill, ps, skill, snice, sysctl, tload, top, 
+uptime, vmstat, w and watch</para></sect3>
 
-</sect2>
-
-<sect2><title>Description</title>
+<sect3><title>Descriptions</title>
 
-<sect3><title>free</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></sect3>
+kernel.</para></sect4>
+
+<sect4><title>kill</title>
+<para>kills sends signals to processes.</para></sect4>
 
-<sect3><title>kill</title>
-<para>kills sends signals to processes.</para></sect3>
+<sect4><title>oldps and ps</title>
+<para>ps gives a snapshot of the current processes.</para></sect4>
 
-<sect3><title>oldps and ps</title>
-<para>ps gives a snapshot of the current processes.</para></sect3>
+<sect4><title>pgrep</title>
+<para>pgrep looks up processes based on name and other attributes</para></sect4>
 
-<sect3><title>skill</title>
-<para>skill sends signals to process matching a criteria.</para></sect3>
+<sect4><title>pkill</title>
+<para>pkill signals processes based on name and other attributes</para></sect4>
 
-<sect3><title>snice</title>
+<sect4><title>skill</title>
+<para>skill sends signals to process matching a criteria.</para></sect4>
+
+<sect4><title>snice</title>
 <para>snice changes the scheduling priority for process matching a 
-criteria.</para></sect3>
+criteria.</para></sect4>
 
-<sect3><title>sysctl</title>
-<para>sysctl modifies kernel parameters at runtime.</para></sect3>
+<sect4><title>sysctl</title>
+<para>sysctl modifies kernel parameters at runtime.</para></sect4>
 
-<sect3><title>tload</title>
+<sect4><title>tload</title>
 <para>tload prints a graph of the current system load average to the 
 specified tty (or the tty of the tload process if 
-none is specified).</para></sect3>
+none is specified).</para></sect4>
 
-<sect3><title>top</title>
+<sect4><title>top</title>
 <para>top provides an ongoing look at processor activity 
-in real time.</para></sect3>
+in real time.</para></sect4>
 
-<sect3><title>uptime</title>
+<sect4><title>uptime</title>
 <para>uptime gives a one line display of the following information: the current 
 time, how long the system has been running, how many users are currently 
 logged on, and the system load averages for the past 1, 5, and 15 
-minutes.</para></sect3>
+minutes.</para></sect4>
 
-<sect3><title>vmstat</title>
+<sect4><title>vmstat</title>
 <para>vmstat reports information about processes, memory, paging, block IO, 
-traps, and cpu activity.</para></sect3>
+traps, and cpu activity.</para></sect4>
 
-<sect3><title>w</title>
+<sect4><title>w</title>
 <para>w displays information about the users currently on the machine, and 
-their processes.</para></sect3>
+their processes.</para></sect4>
 
-<sect3><title>watch</title>
+<sect4><title>watch</title>
 <para>watch runs command repeatedly, displaying its output (the first 
-screen full).</para></sect3>
+screen full).</para></sect4>
+
+</sect3>
+
+<sect3><title>Library Files</title>
+<para>libproc.so</para></sect3>
+
+<sect3><title>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>
+
+</sect3>
 
 </sect2>