Index: appendixa/bison-dep.xml
===================================================================
--- appendixa/bison-dep.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/bison-dep.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Bison Installation Dependencies</title>
Index: appendixa/bison-desc.xml
===================================================================
--- appendixa/bison-desc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/bison-desc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,14 +1,11 @@
-<sect2><title>Contents of Bison</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &bison-contversion;.</para>
 
-<sect3><title>Program Files</title>
-
-<para>bison and yacc</para></sect3>
-
-<sect3><title>Descriptions</title>
+<sect3><title>Program file descriptions</title>
 
 <sect4><title>bison</title>
-
 <para>bison is a parser generator, a replacement for yacc. yacc stands for Yet
 Another Compiler Compiler. What is bison then? It is a program that
@@ -47,5 +44,4 @@
 
 <sect4><title>yacc</title>
-
 <para>This bash script calls bison using the -y option. This is for
 compatibility purposes for programs which use yacc instead of
Index: appendixa/bison-shortdesc.xml
===================================================================
--- appendixa/bison-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
+++ appendixa/bison-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -0,0 +1,14 @@
+<sect2><title>Contents of Bison</title>
+
+<para>Last checked against version &bison-contversion;.</para>
+
+<para>Bison is a parser generator, a replacement for yacc. Bison
+generates a program that analyzes the structure of a text file.</para>
+
+<para>Bison installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>bison and yacc</para></sect3>
+
+</sect2>
+
Index: appendixa/bison.xml
===================================================================
--- appendixa/bison.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/bison.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,4 +4,5 @@
 
 &aa-bison-down;
+&aa-bison-shortdesc;
 &aa-bison-desc;
 &aa-bison-dep;
Index: appendixa/fileutils-shortdesc.xml
===================================================================
--- appendixa/fileutils-shortdesc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/fileutils-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,5 +4,5 @@
 
 <para>Fileutils is a package containing basic file manipulation programs.
-Included are programs to list directories, create directories, update
+Included are programs to list and create directories, update
 timestamps, change permissions and so forth.</para>
 
Index: appendixa/flex-dep.xml
===================================================================
--- appendixa/flex-dep.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/flex-dep.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Flex Installation Dependencies</title>
Index: appendixa/flex-desc.xml
===================================================================
--- appendixa/flex-desc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/flex-desc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,10 +1,9 @@
-<sect2><title>Contents of Flex</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &flex-contversion;.</para>
 
-<sect3><title>Program Files</title>
-<para>flex, flex++ (link to flex) and lex</para></sect3>
-
-<sect3><title>Descriptions</title>
+<sect3><title>Program file descriptions</title>
 
 <sect4><title>flex</title>
@@ -27,8 +26,5 @@
 </sect3>
 
-<sect3><title>Library Files</title>
-<para>libfl.a</para></sect3>
-
-<sect3><title>Descriptions</title>
+<sect3><title>Library file descriptions</title>
 
 <sect4><title>libfl</title>
Index: appendixa/flex-shortdesc.xml
===================================================================
--- appendixa/flex-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
+++ appendixa/flex-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -0,0 +1,17 @@
+<sect2><title>Contents of Flex</title>
+
+<para>Last checked against version &flex-contversion;.</para>
+
+<para>The Flex package is used to generate programs which recognize
+patterns in text.</para>
+
+<para>Flex installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>flex, flex++ (link to flex) and lex</para></sect3>
+
+<sect3><title>Library Files</title>
+<para>libfl.a</para></sect3>
+
+</sect2>
+
Index: appendixa/flex.xml
===================================================================
--- appendixa/flex.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/flex.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,4 +4,5 @@
 
 &aa-flex-down;
+&aa-flex-shortdesc;
 &aa-flex-desc;
 &aa-flex-dep;
Index: appendixa/gettext-dep.xml
===================================================================
--- appendixa/gettext-dep.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/gettext-dep.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Gettext Installation Dependencies</title>
Index: appendixa/gettext-desc.xml
===================================================================
--- appendixa/gettext-desc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/gettext-desc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,13 +1,9 @@
-<sect2><title>Contents of Gettext</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &gettext-contversion;.</para>
 
-<sect3><title>Program Files</title>
-<para>config.charset, config.rpath, gettext, gettextize, hostname,
-msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen, msgexec, msgfilter,
-msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq, ngettext, project-id,
-team-address, trigger, urlget, user-email and xgettext</para></sect3>
-
-<sect3><title>Descriptions</title>
+<sect3><title>Program file descriptions</title>
 
 <sect4><title>config.charset</title>
@@ -120,8 +116,5 @@
 </sect3>
 
-<sect3><title>Library Files</title>
-<para>libgettextlib[a,so], libgettextsrc[a,so]</para></sect3>
-
-<sect3><title>Descriptions</title>
+<sect3><title>Library file descriptions</title>
 
 <sect4><title>libgettextlib</title>
Index: appendixa/gettext-shortdesc.xml
===================================================================
--- appendixa/gettext-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
+++ appendixa/gettext-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -0,0 +1,21 @@
+<sect2><title>Contents of Gettext</title>
+
+<para>Last checked against version &gettext-contversion;.</para>
+
+<para>The Gettext package is used for internationalization and
+localization. Programs can be compiled with Native Language Support
+(NLS) which enable them to output messages in the user's native
+language.</para>
+
+<para>Gettext installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>config.charset, config.rpath, gettext, gettextize, hostname,
+msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen, msgexec, msgfilter,
+msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq, ngettext, project-id,
+team-address, trigger, urlget, user-email and xgettext</para></sect3>
+
+<sect3><title>Library Files</title>
+<para>libgettextlib[a,so], libgettextsrc[a,so]</para></sect3>
+
+</sect2>
Index: appendixa/gettext.xml
===================================================================
--- appendixa/gettext.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/gettext.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,4 +4,5 @@
 
 &aa-gettext-down;
+&aa-gettext-shortdesc;
 &aa-gettext-desc;
 &aa-gettext-dep;
Index: appendixa/groff-dep.xml
===================================================================
--- appendixa/groff-dep.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/groff-dep.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Groff Installation Dependencies</title>
Index: appendixa/groff-desc.xml
===================================================================
--- appendixa/groff-desc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/groff-desc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,3 +1,5 @@
-<sect2><title>Contents of Groff</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &groff-contversion;.</para>
Index: appendixa/groff-shortdesc.xml
===================================================================
--- appendixa/groff-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
+++ appendixa/groff-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -0,0 +1,19 @@
+<sect2><title>Contents of Groff</title>
+
+<para>Last checked against version &groff-contversion;.</para>
+
+<para>The Groff package includes several text processing programs
+for text formatting. Groff translates standard text and special
+commands into formatted output, such as what you see in a manual
+page.</para>
+
+<para>Groff installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>addftinfo, afmtodit, eqn, geqn (link to eqn), grn, grodvi,
+groff, grog, grolbp, grolj4, grops, grotty, gtbl (link to tbl),
+hpftodit, indxbib, lkbib, lookbib, mmroff, neqn, nroff, pfbtops,
+pic, post-grohtml, pre-grohtml, refer, soelim, tbl, tfmtodit,
+troff and zsoelim (link to soelim)</para></sect3>
+
+</sect2>
Index: appendixa/groff.xml
===================================================================
--- appendixa/groff.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/groff.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,4 +4,5 @@
 
 &aa-groff-down;
+&aa-groff-shortdesc;
 &aa-groff-desc;
 &aa-groff-dep;
Index: appendixa/less-dep.xml
===================================================================
--- appendixa/less-dep.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/less-dep.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Less Installation Dependencies</title>
Index: appendixa/less-desc.xml
===================================================================
--- appendixa/less-desc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/less-desc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,10 +1,9 @@
-<sect2><title>Contents of Less</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &less-contversion;.</para>
 
-<sect3><title>Program Files</title>
-<para>less, lessecho and lesskey</para></sect3>
-
-<sect3><title>Description</title>
+<sect3><title>Program file descriptions</title>
 
 <sect4><title>less</title>
Index: appendixa/less-shortdesc.xml
===================================================================
--- appendixa/less-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
+++ appendixa/less-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -0,0 +1,16 @@
+<sect2><title>Contents of Less</title>
+
+<para>Last checked against version &less-contversion;.</para>
+
+<para>Less is a file pager, or text viewer. It displays the contents
+of a file, or stream, and has the ability to scroll. Less has a few
+features not included in the <userinput>more</userinput> pager,
+such as the ability to scroll backwards.</para>
+
+<para>Less installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>less, lessecho and lesskey</para></sect3>
+
+</sect2>
+
Index: appendixa/less.xml
===================================================================
--- appendixa/less.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/less.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,4 +4,5 @@
 
 &aa-less-down;
+&aa-less-shortdesc;
 &aa-less-desc;
 &aa-less-dep;
Index: appendixa/m4-dep.xml
===================================================================
--- appendixa/m4-dep.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/m4-dep.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>M4 Installation Dependencies</title>
Index: appendixa/m4-desc.xml
===================================================================
--- appendixa/m4-desc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/m4-desc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,10 +1,9 @@
-<sect2><title>Contents of M4</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &m4-contversion;.</para>
 
-<sect3><title>Program Files</title>
-<para>m4</para></sect3>
-
-<sect3><title>Descriptions</title>
+<sect3><title>Program file descriptions</title>
 
 <sect4><title>m4</title>
Index: appendixa/m4-shortdesc.xml
===================================================================
--- appendixa/m4-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
+++ appendixa/m4-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -0,0 +1,18 @@
+<sect2><title>Contents of M4</title>
+
+<para>Last checked against version &m4-contversion;.</para>
+
+<para>M4 is a macro processor. It copies input to output, expanding
+macros as it goes. Macros are either built-in or user-defined and can
+take any number of arguments. Besides just doing macro expansion, m4
+has built-in functions for including named files, running Unix
+commands, doing integer arithmetic, manipulating text in various ways,
+recursion, etc. The m4 program can be used either as a front-end to a
+compiler or as a macro processor in its own right.</para>
+
+<para>M4 installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>m4</para></sect3>
+
+</sect2>
Index: appendixa/m4.xml
===================================================================
--- appendixa/m4.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/m4.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,4 +4,5 @@
 
 &aa-m4-down;
+&aa-m4-shortdesc;
 &aa-m4-desc;
 &aa-m4-dep;
Index: appendixa/nettools-dep.xml
===================================================================
--- appendixa/nettools-dep.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/nettools-dep.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,2 +1,4 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Net-tools Installation Dependencies</title>
Index: appendixa/nettools-desc.xml
===================================================================
--- appendixa/nettools-desc.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/nettools-desc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -1,14 +1,9 @@
-<sect2><title>Contents of Net-tools</title>
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
 
 <para>Last checked against version &net-tools-contversion;.</para>
 
-<sect3><title>Program Files</title>
-
-<para>arp, dnsdomainname (link to hostname), domainname (link to
-hostname), hostname, ifconfig, nameif, netstat, nisdomainname (link to
-hostname), plipconfig, rarp, route, slattach and ypdomainname (link to
-hostname)</para></sect3>
-
-<sect3><title>Descriptions</title>
+<sect3><title>Program file descriptions</title>
 
 <sect4><title>arp</title>
Index: appendixa/nettools-shortdesc.xml
===================================================================
--- appendixa/nettools-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
+++ appendixa/nettools-shortdesc.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -0,0 +1,17 @@
+<sect2><title>Contents of Net-tools</title>
+
+<para>Last checked against version &net-tools-contversion;.</para>
+
+<para>The Net-tools package contains a collection of programs
+which form the base of Linux networking.</para>
+
+<para>Net-tools installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>arp, dnsdomainname (link to hostname), domainname (link to
+hostname), hostname, ifconfig, nameif, netstat, nisdomainname (link to
+hostname), plipconfig, rarp, route, slattach and ypdomainname (link to
+hostname)</para></sect3>
+
+</sect2>
+
Index: appendixa/nettools.xml
===================================================================
--- appendixa/nettools.xml	(revision f5ab23e287e91a6f1bcaf77c5da82775bfc3d64c)
+++ appendixa/nettools.xml	(revision b7d9d404530bb763fc76017744709800796af054)
@@ -4,4 +4,5 @@
 
 &aa-nettools-down;
+&aa-nettools-shortdesc;
 &aa-nettools-desc;
 &aa-nettools-dep;
