Changing the style of the 'Content' subsections.

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

appendixa/autoconf-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &autoconf-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>autoconf</command> is a tool for producing shell scripts
 that automatically configure software source code packages to adapt to many
@@ -40,7 +36,5 @@ determine what <userinput>configure</userinput> needs to check. It can fill
 in some gaps in a <filename>configure.in</filename> file generated by
 autoscan.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/autoconf-shortdesc.xml

@@ -1,13 +1,11 @@
 <sect2><title>Contents of Autoconf</title>
 
 <para>(Last checked against version &autoconf-contversion;.)</para>
+
 <para>Autoconf produces shell scripts which automatically configure source
 code.</para>
 
-<para>Autoconf installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>autoconf, autoheader, autom4te, autoreconf, autoscan, autoupdate and 
-ifnames</para></sect3>
+<para><emphasis>Installed programs</emphasis>: autoconf, autoheader, autom4te,
+autoreconf, autoscan, autoupdate and ifnames</para>
 
 </sect2>

appendixa/automake-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &automake-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>acinstall</command> is a script that installs
 aclocal-style M4 files.</para>
@@ -50,7 +46,5 @@ tree.</para>
 
 <para><command>ylwrap</command> is a wrapper for lex and yacc.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/automake-shortdesc.xml

@@ -3,11 +3,10 @@
 <para>(Last checked against version &automake-contversion;.)</para>
 
 <para>Automake generates Makefile.in files, intended for use with Autoconf.</para>
-<para>Automake installs the following:</para>
 
-<sect3><title>Program Files</title>
-<para>acinstall, aclocal, aclocal-1.6, automake, automake-1.6,
-compile, config.guess, config.sub, depcomp, elisp-comp, install-sh,
-mdate-sh, missing, mkinstalldirs, py-compile, ylwrap</para></sect3>
+<para><emphasis>Installed programs</emphasis>: acinstall, aclocal,
+aclocal-1.6, automake, automake-1.6, compile, config.guess, config.sub,
+depcomp, elisp-comp, install-sh, mdate-sh, missing, mkinstalldirs, py-compile,
+ylwrap</para>
 
 </sect2>

appendixa/bash-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &bash-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>bash</command> is a widely-used command interpreter. It
 performs all kinds of expansions and substitutions on a given command line
@@ -17,7 +13,5 @@ compose and mail bug reports concerning bash in a standard format.</para>
 as sh, bash tries to mimic the startup behavior of historical versions of sh as
 closely as possible, while conforming to the POSIX standard as well.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/bash-shortdesc.xml

@@ -8,10 +8,8 @@ input (the keyboard). A user types something and the program will evaluate
 what he has typed and do something with it, like running a
 program.</para>
 
-<para>Bash installs the following files:</para>
-
-<sect3><title>Program Files</title>
-<para>bash, sh (link to bash) and bashbug</para></sect3>
+<para><emphasis>Installed programs</emphasis>: bash, sh (link to bash) and
+bashbug</para>
 
 </sect2>
 

appendixa/binutils-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &binutils-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>addr2line</command> translates program addresses to file
 names and line numbers. Given an address and the name of an executable, it
@@ -51,17 +47,11 @@ and loading sections. For other types of files it scans the whole file.</para>
 
 <para><command>strip</command> discards symbols from object files.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libbfd</command> is the Binary File Descriptor library.</para>
 
 <para><command>libopcodes</command> is a library for dealing with opcodes.
 It is used for building utilities like objdump. Opcodes are the "readable text"
 versions of instructions for the processor.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/binutils-shortdesc.xml

@@ -6,15 +6,11 @@
 linker, assembler and other tools to work with object files and
 archives.</para>
 
-<para>Binutils installs the following files:</para>
+<para><emphasis>Installed programs</emphasis>: addr2line, ar, as, gprof, ld,
+nm, objcopy, objdump, ranlib, readelf, size, strings and strip</para>
 
-<sect3><title>Program Files</title>
-
-<para>addr2line, ar, as, gprof, ld, nm, objcopy, objdump, 
-ranlib, readelf, size, strings and strip</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libbfd.[a,so] and libopcodes.[a,so]</para></sect3>
+<para><emphasis>Installed libraries</emphasis>: libbfd.[a,so] and
+libopcodes.[a,so]</para>
 
 </sect2>
 

appendixa/bison-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &bison-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>bison</command> generates, from a series of rules, a program
 for analyzing the structure of text files. Bison is a replacement for yacc
@@ -13,7 +9,5 @@ for analyzing the structure of text files. Bison is a replacement for yacc
 <para><command>yacc</command> is a wrapper for bison, meant for programs
 that still call yacc instead of bison. It calls bison with the -y option.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/bison-shortdesc.xml

@@ -5,10 +5,7 @@
 <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>
+<para><emphasis>Installed programs</emphasis>: bison and yacc</para>
 
 </sect2>
 

appendixa/bootscripts-desc.xml

@@ -1,19 +1,16 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &bootscripts-contversion;.)</para>
-
-<sect3><title>Script descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para>The <command>checkfs</command> script checks the file systems just
 before they are mounted (with the exception of journal and network based file
 systems).</para>
 
-<para>The <command>cleanfs</command> script removes files that shouldn't be preserved between
-reboots, such as /var/run/* and /var/lock/*. It re-creates /var/run/utmp and
-removes the possibly present /etc/nologin, /fastboot and /forcefsck
-files.</para>
+<para>The <command>cleanfs</command> script removes files that shouldn't be
+preserved between reboots, such as those in <filename>/var/run/</filename> and
+<filename>/var/lock/</filename>. It re-creates <filename>/var/run/utmp</filename>
+and removes the possibly present <filename>/etc/nologin</filename>,
+<filename>/fastboot</filename> and <filename>/forcefsck</filename> files.</para>
 
 <para>The <command>functions</command> script contains functions shared among
 different scripts, such as error and status checking.</para>
@@ -59,7 +56,5 @@ kernel log daemons.</para>
 <para>The <command>template</command> script is a template you can use to
 create your own bootscripts for your other daemons.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/bootscripts-shortdesc.xml

@@ -7,12 +7,9 @@ scripts. These scripts do various tasks such as check filesystem
 integrity during boot, load keymaps, set up networks and halt
 processes at shutdown.</para>
 
-<para>LFS-bootscripts installs the following:</para>
-
-<sect3><title>Scripts</title>
-<para>checkfs, cleanfs, functions, halt, ifdown, ifup, loadkeys, localnet,
-mountfs, mountproc, network, rc, reboot, sendsignals, setclock, swap,
-sysklogd and template</para></sect3>
+<para><emphasis>Installed scripts</emphasis>: checkfs, cleanfs, functions,
+halt, ifdown, ifup, loadkeys, localnet, mountfs, mountproc, network, rc,
+reboot, sendsignals, setclock, swap, sysklogd and template</para>
 
 </sect2>
 

appendixa/bzip2-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &bzip2-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>bunzip2</command> decompresses bzipped files.</para>
 
@@ -28,14 +24,8 @@ bzip2 files.</para>
 
 <para><command>bzmore</command> runs more on bzipped files.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libbz2*</command> is the library implementing lossless,
 block-sorting data compression, using the Burrows-Wheeler algorithm.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/bzip2-shortdesc.xml

@@ -6,14 +6,12 @@
 better compression than the traditional <userinput>gzip</userinput>
 does.</para>
 
-<para>Bzip2 installs the following files:</para>
+<para><emphasis>Installed programs</emphasis>: bunzip2 (link to bzip2), bzcat
+(link to bzip2), bzcmp, bzdiff, bzegrep, bzfgrep, bzgrep, bzip2, bzip2recover,
+bzless and bzmore</para>
 
-<sect3><title>Program Files</title>
-<para>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp, bzdiff, bzegrep,
-bzfgrep, bzgrep, bzip2, bzip2recover, bzless and bzmore</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libbz2.a, libbz2.so (link to libbz2.so.1.0), libbz2.so.1.0 (link to
-libbz2.so.1.0.2) and libbz2.so.1.0.2</para></sect3>
+<para><emphasis>Installed libraries</emphasis>: libbz2.a, libbz2.so (link to
+libbz2.so.1.0), libbz2.so.1.0 (link to libbz2.so.1.0.2) and
+libbz2.so.1.0.2</para>
 
 </sect2>

appendixa/coreutils-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against the old Fileutils, Sh-utils and Textutils.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>basename</command> strips any path and a given suffix from
 the given file name.</para>
@@ -242,7 +238,5 @@ current effective user ID.</para>
 <para><command>yes</command> outputs 'y' or a given string repeatedly,
 until killed.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/coreutils-shortdesc.xml

@@ -2,17 +2,17 @@
 
 <para>The Coreutils package contains a whole series of basic shell utilities.</para>
 
-<para>Coreutils installs the following:</para>
+<para>(Last checked against the old Fileutils, Sh-utils and Textutils.)</para>
 
-<sect3><title>Program Files</title>
-<para>basename, cat, chgrp, chmod, chown, chroot, cksum, comm, cp, csplit,
-cut, date, dd, df, dir, dircolors, dirname, du, echo, env, expand, expr,
-factor, false, fmt, fold, groups, head, hostid, hostname, id, install, join,
-kill, link, ln, logname, ls, md5sum, mkdir, mkfifo, mknod, mv, nice, nl,
-nohup, od, paste, pathchk, pinky, pr, printenv, printf, ptx, pwd, readlink,
-rm, rmdir, seq, sha1sum, shred, sleep, sort, split, stat, stty, su, sum, sync,
-tac, tail, tee, test, touch, tr, true, tsort, tty, uname, unexpand, uniq,
-unlink, uptime, users, vdir, wc, who, whoami, yes</para></sect3>
+<para><emphasis>Installed programs</emphasis>: basename, cat, chgrp, chmod,
+chown, chroot, cksum, comm, cp, csplit, cut, date, dd, df, dir, dircolors,
+dirname, du, echo, env, expand, expr, factor, false, fmt, fold, groups, head,
+hostid, hostname, id, install, join, kill, link, ln, logname, ls, md5sum,
+mkdir, mkfifo, mknod, mv, nice, nl, nohup, od, paste, pathchk, pinky, pr,
+printenv, printf, ptx, pwd, readlink, rm, rmdir, seq, sha1sum, shred, sleep,
+sort, split, stat, stty, su, sum, sync, tac, tail, tee, test, touch, tr, true,
+tsort, tty, uname, unexpand, uniq, unlink, uptime, users, vdir, wc, who,
+whoami and yes</para>
 
 </sect2>
 

appendixa/dejagnu-desc.xml

@@ -1,10 +1,8 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &dejagnu-contversion;.)</para>
+<sect2><title>Short description</title>
 
 <para><command>runtest</command> is the wrapper script that finds the proper
-expect shell then runs DejaGnu</para>
+expect shell and then runs DejaGnu.</para>
 
 </sect2>

appendixa/dejagnu-shortdesc.xml

@@ -4,11 +4,7 @@
 
 <para>The DejaGnu package contains a framework for testing other programs.</para>
 
-<para>DejaGnu installs the following files:</para>
-
-<sect3><title>Program Files</title>
-
-<para>runtest</para></sect3>
+<para><emphasis>Installed program</emphasis>: runtest</para>
 
 </sect2>
 

appendixa/diffutils-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &diffutils-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>cmp</command> compares two files and reports whether or
 in which bytes they differ.</para>
@@ -17,7 +13,5 @@ which lines in the files differ.</para>
 <para><command>sdiff</command> merges two files and interactively outputs
 the results.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/diffutils-shortdesc.xml

@@ -6,10 +6,7 @@
 files or directories. It's most common use is to create software
 patches.</para>
 
-<para>Diffutils installs the following files:</para>
-
-<sect3><title>Program Files</title>
-<para>cmp, diff, diff3 and sdiff</para></sect3>
+<para><emphasis>Installed programs</emphasis>: cmp, diff, diff3 and sdiff</para>
 
 </sect2>
 

appendixa/e2fsprogs-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &e2fsprogs-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>badblocks</command> searches a device (usually a disk
 partition) for bad blocks.</para>
@@ -60,10 +56,6 @@ identifiers (UUID). Each new UUID can reasonably be considered unique
 among all UUIDs created, on the local system and on other systems, in the
 past and in the future.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libcom_err</command> is the common error display routine.</para>
 
 <para><command>libe2p</command> is used by dumpe2fs, chattr, and lsattr.</para>
@@ -76,7 +68,5 @@ programs to manipulate an ext2 filesystem.</para>
 <para><command>libuuid</command> contains routines for generating unique
 identifiers for objects that may be accessible beyond the local system.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/e2fsprogs-shortdesc.xml

@@ -6,20 +6,13 @@
  ext2 filesystem. It also supports the ext3 filesystem with journaling
  support.</para>
 
-<para>E2fsprogs installs the following:</para>
-
-<sect3><title>Program Files</title>
-
-<para>badblocks, chattr, compile_et, debugfs, dumpe2fs, e2fsck, 
-e2image, e2label, fsck, fsck.ext2, fsck.ext3, lsattr, mk_cmds, mke2fs, 
-mkfs.ext2, mkfs.ext3, mklost+found, resize2fs, tune2fs and
-uuidgen</para></sect3>
-
-<sect3><title>Library Files</title>
-
-<para>libcom_err.[a,so], libe2p.[a,so], libext2fs.[a,so], libss.[a,so],
-libuuid.[a,so]</para></sect3>
+<para><emphasis>Installed programs</emphasis>: badblocks, chattr, compile_et,
+debugfs, dumpe2fs, e2fsck, e2image, e2label, fsck, fsck.ext2, fsck.ext3,
+lsattr, mk_cmds, mke2fs, mkfs.ext2, mkfs.ext3, mklost+found, resize2fs,
+tune2fs and uuidgen</para>
 
+<para><emphasis>Installed libraries</emphasis>: libcom_err.[a,so],
+libe2p.[a,so], libext2fs.[a,so], libss.[a,so] and libuuid.[a,so]</para>
 
 </sect2>
 

appendixa/ed-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &ed-contversion;.)</para>
-
-<sect3><title>Program file description</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>ed</command> is a line-oriented text editor. It can be used
 to create, display, modify and otherwise manipulate text files.</para>
@@ -12,7 +8,5 @@ to create, display, modify and otherwise manipulate text files.</para>
 <para><command>red</command> is a restricted ed -- it can only edit files
 in the current directory and cannot execute shell commands.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/ed-shortdesc.xml

@@ -4,10 +4,7 @@
 
 <para>GNU ed is an 8-bit clean, POSIX-compliant line editor.</para>
 
-<para>Ed installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>ed and red (link to ed)</para></sect3>
+<para><emphasis>Installed programs</emphasis>: ed and red (link to ed)</para>
 
 </sect2>
 

appendixa/expect-desc.xml

@@ -1,8 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &expect-contversion;.)</para>
+<sect2><title>Short description</title>
 
 <para><command>expect</command> "talks" to other interactive programs according
 to a script.</para>

appendixa/expect-shortdesc.xml

@@ -5,14 +5,9 @@
 <para>The Expect package provides a program that performs programmed dialogue
 with other interactive programs.</para>
 
-<para>Expect installs the following files:</para>
+<para><emphasis>Installed program</emphasis>: expect</para>
 
-<sect3><title>Program Files</title>
-
-<para>expect</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libexpect5.39.a</para></sect3>
+<para><emphasis>Installed library</emphasis>: libexpect5.39.a</para>
 
 </sect2>
 

appendixa/file-desc.xml

@@ -1,16 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Description</title>
-
-<para>(Last checked against version &file-contversion;.)</para>
-
-<sect3><title>Program file description</title>
+<sect2><title>Short description</title>
 
 <para><command>file</command> tries to classify each given file. It does
 this by performing several tests: filesystem tests, magic number tests, and
 language tests. The first test that succeeds determines the result.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/file-shortdesc.xml

@@ -4,10 +4,7 @@
 
 <para>File is a utility used to determine file types.</para>
 
-<para>File installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>file</para></sect3>
+<para><emphasis>Installed program</emphasis>: file</para>
 
 </sect2>
 

appendixa/findutils-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &findutils-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>bigram</command> was formerly used to produce locate
 databases.</para>
@@ -29,7 +25,5 @@ unless told not to) and puts every file name it finds in the database.</para>
 <para><command>xargs</command> can be used to apply a given command to
 a list of files.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/findutils-shortdesc.xml

@@ -7,11 +7,8 @@ on-the-fly (by doing a live recursive search through directories and only
 showing files that match the specifications) or by searching through a
 database.</para>
 
-<para>Findutils installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>bigram, code, find, frcode, locate, updatedb and
-xargs</para></sect3>
+<para><emphasis>Installed programs</emphasis>: bigram, code, find, frcode,
+locate, updatedb and xargs</para>
 
 </sect2>
 

appendixa/flex-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &flex-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>flex</command> is a tool for generating programs that
 recognize patterns in text. Pattern recognition is useful in many applications.
@@ -15,13 +11,7 @@ the rules for than to write the actual pattern-finding program.</para>
 <para><command>flex++</command> invokes a version of flex that is used
 exclusively for C++ scanners.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libfl.a</command> is the flex library.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/flex-shortdesc.xml

@@ -5,13 +5,10 @@
 <para>The Flex package is used to generate programs which recognize
 patterns in text.</para>
 
-<para>Flex installs the following:</para>
+<para><emphasis>Installed programs</emphasis>: flex, flex++ (link to flex)
+and lex</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>
+<para><emphasis>Installed library</emphasis>: libfl.a</para>
 
 </sect2>
 

appendixa/gawk-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &gawk-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>gawk</command> is a program for manipulating text files.
 It is the GNU implementation of awk.</para>
@@ -20,7 +16,5 @@ include files.</para>
 <para><command>pwcat</command> dumps the password database
 <filename>/etc/passwd</filename>.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/gawk-shortdesc.xml

@@ -5,10 +5,7 @@
 <para>Gawk is an awk implementation that is used to manipulate text
 files.</para>
 
-<para>Gawk installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>awk, gawk, gawk-3.1.1, grcat, igawk, pgawk, pgawk-3.1.1,
-pwcat</para></sect3>
+<para><emphasis>Installed programs</emphasis>: awk, gawk, gawk-3.1.1, grcat,
+igawk, pgawk, pgawk-3.1.1 and pwcat</para>
 
 </sect2>

appendixa/gcc-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &gcc-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>c++filt</command> is used by the linker to demangle C++
 symbols, to keep overloaded functions from clashing.</para>
@@ -24,10 +20,6 @@ good bug reports.</para>
 <para><command>gcov</command> is a coverage testing tool. It is used to
 analyze programs to find out where optimizations will have the most effect.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libgcc*</command> contains run-time support for gcc.</para>
 
 <para><command>libiberty</command> contains routines used by various GNU
@@ -39,7 +31,5 @@ many frequently-used functions.</para>
 <para><command>libsupc++</command> provides supporting routines
 for the c++ programming language.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/gcc-shortdesc.xml

@@ -5,15 +5,11 @@
 <para>The GCC package contains the GNU compiler collection, including
 the C and C++ compilers.</para>
 
-<para>GCC installs the following files:</para>
+<para><emphasis>Installed programs</emphasis>: c++, c++filt, cc (link to gcc),
+cc1, cc1plus, collect2, cpp, cpp0, g++, gcc, gccbug, gcov and tradcpp0</para>
 
-<sect3><title>Program Files</title>
-<para>c++, c++filt, cc (link to gcc), cc1, cc1plus, collect2, cpp, cpp0,
-g++, gcc, gccbug, gcov and tradcpp0</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libgcc.a, libgcc_eh.a, libgcc_s.so, libiberty.a, libstdc++.[a,so], 
-libsupc++.a</para></sect3>
+<para><emphasis>Installed libraries</emphasis>: libgcc.a, libgcc_eh.a,
+libgcc_s.so, libiberty.a, libstdc++.[a,so] and libsupc++.a</para>
 
 </sect2>
 

appendixa/gettext-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &gettext-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>config.charset</command> outputs a system-dependent table of
 character encoding aliases.</para>
@@ -70,15 +66,9 @@ textual message whose grammatical form depends on a number.</para>
 <para><command>xgettext</command> extracts the translatable message lines
 from the given source files, to make the first translation template.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libgettextlib</command>...</para>
 
 <para><command>libgettextsrc</command>...</para>
 
-</sect3>
-
 </sect2>
 

appendixa/gettext-shortdesc.xml

@@ -7,15 +7,13 @@ 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>
+<para><emphasis>Installed programs</emphasis>: 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><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>
+<para><emphasis>Installed libraries</emphasis>: libgettextlib[a,so] and
+libgettextsrc[a,so]</para>
 
 </sect2>

appendixa/glibc-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &glibc-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>catchsegv</command> can be used to create a stack trace
 when a program terminates with a segmentation fault.</para>
@@ -74,10 +70,6 @@ printing the currently executed function.</para>
 
 <para><command>zic</command> is the time zone compiler.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>ld.so</command> is the helper program for shared library
 executables.</para>
 
@@ -137,7 +129,5 @@ building debuggers for multi-threaded programs.</para>
 <para><command>libutil</command> contains code for "standard" functions
 used in many different Unix utilities.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/glibc-shortdesc.xml

@@ -6,27 +6,18 @@
 functions such as open, malloc, printf, etc. The C library is used by all
 dynamically linked programs.</para>
 
-<para>Glibc installs the following files:</para>
-
-<sect3><title>Program Files</title>
-
-<para>catchsegv, gencat, getconf, getent, glibcbug, iconv, iconvconfig,
-ldconfig, ldd, lddlibc4, locale, localedef, mtrace, nscd, nscd_nischeck,
-pcprofiledump, pt_chown, rpcgen, rpcinfo, sln, sprof, tzselect, xtrace,
-zdump and zic</para>
-
-</sect3>
-
-<sect3><title>Library Files</title>
-<para>ld.so, libBrokenLocale.[a,so], libSegFault.so, libanl.[a,so],
-libbsd-compat.a, libc.[a,so], libc_nonshared.a, libcrypt.[a,so], libdl.[a,so],
-libg.a, libieee.a, libm.[a,so], libmcheck.a, libmemusage.so, libnsl.a,
-libnss_compat.so, libnss_dns.so, libnss_files.so, libnss_hesiod.so,
-libnss_nis.so, libnss_nisplus.so, libpcprofile.so, libpthread.[a,so],
-libresolv.[a,so], librpcsvc.a, librt.[a,so], libthread_db.so and
-libutil.[a,so]</para>
-
-</sect3>
+<para><emphasis>Installed programs</emphasis>: catchsegv, gencat, getconf,
+getent, glibcbug, iconv, iconvconfig, ldconfig, ldd, lddlibc4, locale,
+localedef, mtrace, nscd, nscd_nischeck, pcprofiledump, pt_chown, rpcgen,
+rpcinfo, sln, sprof, tzselect, xtrace, zdump and zic</para>
+
+<para><emphasis>Installed libraries</emphasis>: ld.so, libBrokenLocale.[a,so],
+libSegFault.so, libanl.[a,so], libbsd-compat.a, libc.[a,so], libc_nonshared.a,
+libcrypt.[a,so], libdl.[a,so], libg.a, libieee.a, libm.[a,so], libmcheck.a,
+libmemusage.so, libnsl.a, libnss_compat.so, libnss_dns.so, libnss_files.so,
+libnss_hesiod.so, libnss_nis.so, libnss_nisplus.so, libpcprofile.so,
+libpthread.[a,so], libresolv.[a,so], librpcsvc.a, librt.[a,so], libthread_db.so
+and libutil.[a,so]</para>
 
 </sect2>
 

appendixa/grep-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &grep-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>egrep</command> prints lines matching an extended regular
 expression.</para>
@@ -15,7 +11,5 @@ strings.</para>
 <para><command>grep</command> prints lines matching a basic regular
 expression.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/grep-shortdesc.xml

@@ -5,10 +5,8 @@
 <para>Grep is a program used to print lines from a file matching a
 specified pattern.</para>
 
-<para>Grep installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>egrep (link to grep), fgrep (link to grep) and grep</para></sect3>
+<para><emphasis>Installed programs</emphasis>: egrep (link to grep), fgrep
+(link to grep) and grep</para>
 
 </sect2>
 

appendixa/groff-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &groff-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>addftinfo</command> reads a troff font file and adds some
 additional font-metric information that is used by the groff system.</para>
@@ -99,7 +95,5 @@ appropriate options.</para>
 
 <para><command>zsoelim</command> is the GNU implementation of soelim.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/groff-shortdesc.xml

@@ -7,13 +7,10 @@ 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>
+<para><emphasis>Installed programs</emphasis>: 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>
 
 </sect2>

appendixa/grub-desc.xml

@@ -1,8 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &grub-contversion;.)</para>
+<sect2><title>Short descriptions</title>
 
 <para><command>grub</command> is the GRand Unified Bootloader's command
 shell.</para>

appendixa/grub-shortdesc.xml

@@ -4,9 +4,7 @@
 
 <para>The Grub package contains a bootloader.</para>
 
-<para>Grub installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>grub, grub-install, grub-md5-crypt, grub-terminfo and mbchk</para></sect3>
+<para><emphasis>Installed programs</emphasis>: grub, grub-install,
+grub-md5-crypt, grub-terminfo and mbchk</para>
 
 </sect2>

appendixa/gzip-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &gzip-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>gunzip</command> decompresses gzipped files.</para>
 
@@ -34,7 +30,5 @@ useful when file names were truncated during a file transfer.</para>
 <para><command>znew</command> recompresses files from compress format
 to gzip format -- .Z to .gz.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/gzip-shortdesc.xml

@@ -5,11 +5,8 @@
 <para>The Gzip package contains programs to compress and decompress files
 using the Lempel-Ziv coding (LZ77).</para>
 
-<para>Gzip installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>gunzip (link to gzip), gzexe, gzip,
-uncompress (link to gunzip), zcat (link to gzip), zcmp, zdiff, zforce,
-zgrep, zmore and znew</para></sect3>
+<para><emphasis>Installed programs</emphasis>: gunzip (link to gzip), gzexe,
+gzip, uncompress (link to gunzip), zcat (link to gzip), zcmp, zdiff, zforce,
+zgrep, zmore and znew</para>
 
 </sect2>

appendixa/inetutils-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &inetutils-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>ftp</command> is the ARPANET file transfer program.</para>
 
@@ -23,7 +19,5 @@ long the replies take.</para>
 
 <para><command>tftp</command> is a trivial file transfer program.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/inetutils-shortdesc.xml

@@ -4,9 +4,7 @@
 
 <para>The Inetutils package contains network clients and servers.</para>
 
-<para>Inetutils installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>ftp, ping, rcp, rlogin, rsh, talk, telnet, tftp</para></sect3>
+<para><emphasis>Installed programs</emphasis>: ftp, ping, rcp, rlogin, rsh,
+talk, telnet and tftp</para>
 
 </sect2>

appendixa/kbd-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &kbd-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>chvt</command> changes the foreground virtual terminal.</para>
 
@@ -65,7 +61,5 @@ unicode mode.</para>
 <para><command>unicode_stop</command> reverts keyboard and console from
 unicode mode.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/kbd-shortdesc.xml

@@ -4,16 +4,12 @@
 
 <para>Kbd contains keytable files and keyboard utilities.</para>
 
-<para>Kbd installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>chvt, deallocvt, dumpkeys, fgconsole, 
-getkeycodes, getunimap, kbd_mode, kbdrate, loadkeys, loadunimap,
+<para><emphasis>Installed programs</emphasis>: chvt, deallocvt, dumpkeys,
+fgconsole, getkeycodes, getunimap, kbd_mode, kbdrate, loadkeys, loadunimap,
 mapscrn, openvt, psfaddtable (link to psfxtable), psfgettable (link to
-psfxtable), psfstriptable (link to psfxtable), psfxtable, resizecons, 
-setfont, setkeycodes, setleds, setlogcons,
-setmetamode, setvesablank, showfont, showkey, unicode_start, and
-unicode_stop</para></sect3>
+psfxtable), psfstriptable (link to psfxtable), psfxtable, resizecons,
+setfont, setkeycodes, setleds, setlogcons, setmetamode, setvesablank,
+showfont, showkey, unicode_start and unicode_stop</para>
 
 </sect2>
 

appendixa/kernel-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &kernel-contversion;.)</para>
-
-<sect3><title>File descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para>The <emphasis>kernel</emphasis> is the engine of your GNU/Linux system.
 When switching on your box, the kernel is the first part of your operating
@@ -19,7 +15,5 @@ services that the kernel provides. The headers in your system's
 the ones against which Glibc was compiled and should therefore
 <emphasis>not</emphasis> be replaced when upgrading the kernel.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/kernel-shortdesc.xml

@@ -10,9 +10,7 @@ ports, sound cards, network cards, IDE controllers, SCSI controllers and a
 lot more. In a nutshell the kernel makes the hardware available so that the
 software can run.</para>
 
-<para>Linux installs the following files:</para>
-
-<sect3><title>Files</title>
-<para>kernel and kernel headers</para></sect3>
+<para><emphasis>Installed files</emphasis>: the kernel and the kernel
+headers</para>
 
 </sect2>

appendixa/less-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &less-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>less</command> is a file viewer or pager. It displays the
 contents of the given file, letting you scroll around, find strings, and jump
@@ -16,7 +12,5 @@ such as * and ?, in filenames on Unix systems.</para>
 <para><command>lesskey</command> is used to specify the key bindings
 for less.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/less-shortdesc.xml

@@ -7,10 +7,7 @@ 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>
+<para><emphasis>Installed programs</emphasis>: less, lessecho and lesskey</para>
 
 </sect2>
 

appendixa/lfs-utils-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &lfs-utils-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>mktemp</command> creates temporary files in a secure manner.
 It is used in scripts.</para>
@@ -21,6 +17,4 @@ download from websites without using any other programs.</para>
 script to simplify the process of procuring IANA's services and protocols
 configuration files.</para>
 
-</sect3>
-
 </sect2>

appendixa/lfs-utils-shortdesc.xml

@@ -6,9 +6,7 @@
 various packages, but are not large enough to warrant their own
 individual package.</para>
 
-<para>Lfs-Utils installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>mktemp, tempfile, http-get, iana-net</para></sect3>
+<para><emphasis>Installed programs</emphasis>: mktemp, tempfile, http-get
+and iana-net</para>
 
 </sect2>

appendixa/libtool-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &libtool-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>libtool</command> provides generalized library-building
 support services.</para>
@@ -12,13 +8,7 @@ support services.</para>
 <para><command>libtoolize</command> provides a standard way to add
 libtool support to a package.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libltdl*</command>...</para>
 
-</sect3>
-
 </sect2>
 

appendixa/libtool-shortdesc.xml

@@ -6,14 +6,11 @@
   the complexity of using shared libraries behind a consistent,
   portable interface.</para>
 
-<para>Libtool installs the following:</para>
+<para><emphasis>Installed programs</emphasis>: libtool and libtoolize</para>
 
-<sect3><title>Program Files</title>
-<para>libtool and libtoolize</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libltdl.a, libltdl.so (link to libltdl.so.3.1.0), libltdl.so.3
-(link to libltdl.so.3.1.0) and libltdl.so.3.1.0</para></sect3>
+<para><emphasis>Installed libraries</emphasis>: libltdl.a, libltdl.so
+(link to libltdl.so.3.1.0), libltdl.so.3 (link to libltdl.so.3.1.0) and
+libltdl.so.3.1.0</para>
 
 </sect2>
 

appendixa/m4-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &m4-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>m4</command> copies the given files
 while expanding the macros that they contain. These macros are either built-in
@@ -14,7 +10,5 @@ commands, doing integer arithmetic, manipulating text in various ways,
 recursion, and so on. The m4 program can be used either as a front-end to a
 compiler or as a macro processor in its own right.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/m4-shortdesc.xml

@@ -10,9 +10,6 @@ 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>
+<para><emphasis>Installed program</emphasis>: m4</para>
 
 </sect2>

appendixa/make-desc.xml

@@ -1,15 +1,9 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Description</title>
-
-<para>(Last checked against version &make-contversion;.)</para>
-
-<sect3><title>Program file description</title>
+<sect2><title>Short description</title>
 
 <para><command>make</command> automatically determines which pieces of a
 large package need to be recompiled, and then issues the relevant commands.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/make-shortdesc.xml

@@ -5,10 +5,7 @@
 <para>Make determines, automatically, which pieces of a large program need
 to be recompiled and issues the commands to recompile them.</para>
 
-<para>Make installs the following:</para>
-
-<sect3><title>Program files</title>
-<para>make</para></sect3>
+<para><emphasis>Installed program</emphasis>: make</para>
 
 </sect2>
 

appendixa/makedev-desc.xml

@@ -1,16 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Description</title>
-
-<para>(Last checked against version &makedev-contversion;.)</para>
-
-<sect3><title>Program file description</title>
+<sect2><title>Short description</title>
 
 <para><command>MAKEDEV</command> is a script for creating the necessary
 static device nodes, usually residing in the <filename>/dev</filename>
 directory.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/makedev-shortdesc.xml

@@ -8,9 +8,6 @@ directory. Detailed information about device nodes may be found
 in the <filename>Documentation/devices.txt</filename> file under
 the Linux kernel source tree.</para>
 
-<para>MAKEDEV installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>MAKEDEV</para></sect3>
+<para><emphasis>Installed script</emphasis>: MAKEDEV</para>
 
 </sect2>

appendixa/man-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &man-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>apropos</command> searches the whatis database and displays
 the short descriptions of system commands that contain a given string.</para>
@@ -24,7 +20,5 @@ manual page.</para>
 the short descriptions of system commands that contain the given keyword as a
 separate word.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/man-shortdesc.xml

@@ -4,11 +4,8 @@
 
 <para>Man is a man pager.</para>
 
-<para>Man installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>apropos, makewhatis, man, man2dvi, man2html and
-whatis</para></sect3>
+<para><emphasis>Installed programs</emphasis>: apropos, makewhatis, man,
+man2dvi, man2html and whatis</para>
 
 </sect2>
 

appendixa/manpages-desc.xml

@@ -1,16 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Description</title>
-
-<para>(Last checked against version &man-pages-contversion;.)</para>
-
-<sect3><title>Support file description</title>
+<sect2><title>Short description</title>
 
 <para>Examples of provided <emphasis>manual pages</emphasis> are the pages
 describing all the C and C++ functions, important device files, and important
 configuration files.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/manpages-shortdesc.xml

@@ -7,10 +7,7 @@ documentation details the C and C++ functions, describes a few
 important device files and provides documents which would otherwise
 be missing from other packages.</para>
 
-<para>Man-pages installs the following:</para>
-
-<sect3><title>Support Files</title>
-<para>Various manual pages.</para></sect3>
+<para><emphasis>Installed files</emphasis>: various manual pages</para>
 
 </sect2>
 

appendixa/modutils-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &modutils-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>depmod</command> creates a dependency file, based on the
 symbols it finds in the existing set of modules. This  dependency file is used
@@ -34,7 +30,5 @@ depmod, to automatically load the relevant modules.</para>
 
 <para><command>rmmod</command> unloads modules from the running kernel.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/modutils-shortdesc.xml

@@ -5,12 +5,10 @@
 <para>The Modutils package contains programs that you can use to work with
 kernel modules.</para>
 
-<para>Modutils installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>depmod, genksyms, insmod, insmod_ksymoops_clean, kallsyms (link to
-insmod), kernelversion, ksyms (link to insmod), lsmod (link to insmod), 
-modinfo, modprobe (link to insmod) and rmmod (link to insmod)</para></sect3>
+<para><emphasis>Installed programs</emphasis>: depmod, genksyms, insmod,
+insmod_ksymoops_clean, kallsyms (link to insmod), kernelversion, ksyms
+(link to insmod), lsmod (link to insmod), modinfo, modprobe (link to insmod)
+and rmmod (link to insmod)</para>
 
 </sect2>
 

appendixa/ncurses-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &ncurses-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>captoinfo</command> converts a termcap description into a
 terminfo description.</para>
@@ -37,10 +33,6 @@ a terminal, or report its long name.</para>
 
 <para><command>tset</command> can be used to initialize terminals.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libncurses*</command> contain functions to display text in
 many complicated ways on a terminal screen. A good example of the use of these
 functions is the menu displayed during the kernel's make menuconfig.</para>
@@ -51,7 +43,5 @@ functions is the menu displayed during the kernel's make menuconfig.</para>
 
 <para><command>libpanel*</command> contain functions to implement panels.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/ncurses-shortdesc.xml

@@ -5,16 +5,13 @@
 <para>The Ncurses package provides character and terminal handling
 libraries, including panels and menus.</para>
 
-<para>Ncurses installs the following:</para>
+<para><emphasis>Installed programs</emphasis>: captoinfo (link to tic), clear,
+infocmp, infotocap (link to tic), reset (link to tset), tack, tic, toe, tput
+and tset</para>
 
-<sect3><title>Program Files</title>
-<para>captoinfo (link to tic), clear, infocmp, infotocap (link to tic),
-reset (link to tset), tack, tic, toe, tput and tset.</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libcurses.[a,so] (link to libncurses.[a,so]), libform.[a,so],
-libform_g.a, libmenu.[a,so], libmenu_g.a, libncurses++.a,
-libncurses.[a,so], libncurses_g.a, libpanel.[a,so] and
-libpanel_g.a</para></sect3>
+<para><emphasis>Installed libraries</emphasis>: libcurses.[a,so] (link to
+libncurses.[a,so]), libform.[a,so], libform_g.a, libmenu.[a,so], libmenu_g.a,
+libncurses++.a, libncurses.[a,so], libncurses_g.a, libpanel.[a,so] and
+libpanel_g.a</para>
 
 </sect2>

appendixa/nettools-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &net-tools-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>arp</command> is used to manipulate the kernel's ARP cache,
 usually to add or delete an entry, or to dump the entire cache.</para>
@@ -44,7 +40,5 @@ other computers.</para>
 
 <para><command>ypdomainname</command> does the same as domainname.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/nettools-shortdesc.xml

@@ -5,13 +5,10 @@
 <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>
+<para><emphasis>Installed programs</emphasis>: 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>
 
 </sect2>
 

appendixa/patch-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Description</title>
-
-<para>(Last checked against version &patch-contversion;.)</para>
-
-<sect3><title>Program file description</title>
+<sect2><title>Short description</title>
 
 <para><command>patch</command> modifies files according to a patch file.
 A patch file normally is a difference listing created with the diff program.
@@ -12,7 +8,5 @@ By applying these differences to the original files, patch creates the patched
 versions. Using patches instead a entire new tarballs to keep your sources
 up-to-date can save you a lot of download time.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/patch-shortdesc.xml

@@ -6,10 +6,7 @@
 file usually is a list, created by the diff program, that contains
 instructions on how an original file needs to be modified.</para>
 
-<para>Patch installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>patch</para></sect3>
+<para><emphasis>Installed program</emphasis>: patch</para>
 
 </sect2>
 

appendixa/perl-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &perl-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>a2p</command> translates awk to perl.</para>
 
@@ -62,10 +58,6 @@ documentation.</para>
 <para><command>splain</command> is used to force verbose warning
 diagnostics in perl.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>attrs</command>...</para>
 
 <para><command>B</command>...</para>
@@ -104,7 +96,5 @@ diagnostics in perl.</para>
 
 <para><command>SysV</command>...</para>
 
-</sect3>
-
 </sect2>
 

appendixa/perl-shortdesc.xml

@@ -6,15 +6,14 @@
 and Report Language. Perl combines some of the best features of C,
 sed, awk and sh into one powerful language.</para>
 
-<para>Perl installs the following:</para>
+<para><emphasis>Installed programs</emphasis>: a2p, c2ph, dprofpp, find2perl,
+h2ph, h2xs, perl, perl5.6.1, perlbug, perlcc, perldoc, pl2pm, pod2html,
+pod2latex, pod2man, pod2text, pod2usage, podchecker, podselect, pstruct, s2p
+and splain</para> 
 
-<sect3><title>Program files and libraries</title>
-
-<para>a2p, c2ph, dprofpp, find2perl, h2ph, h2xs, perl, perl5.6.1,
-perlbug, perlcc, perldoc, pl2pm, pod2html, pod2latex, pod2man, pod2text,
-pod2usage, podchecker, podselect, pstruct, s2p, splain,attrs.so, B.so,
-ByteLoader.so, DProf.so, Dumper.so, DynaLoader.a, Fcntl.so, Glob.so,
-Hostname.so, IO.so, libperl.a, Opcode.so, Peek.so, POSIX.so, re.so,
-SDBM_File.so, Socket.so, Syslog.so and SysV.so</para></sect3> 
+<para><emphasis>Installed libraries</emphasis>: attrs.so, B.so, ByteLoader.so,
+DProf.so, Dumper.so, DynaLoader.a, Fcntl.so, Glob.so, Hostname.so, IO.so,
+libperl.a, Opcode.so, Peek.so, POSIX.so, re.so, SDBM_File.so, Socket.so,
+Syslog.so and SysV.so</para>
 
 </sect2>

appendixa/procinfo-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &procinfo-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>lsdev</command> lists the devices present in your system,
 and which IRQs and IO ports they use.</para>
@@ -15,7 +11,5 @@ present in the virtual proc filesystem.</para>
 <para><command>socklist</command> lists the open sockets, reporting their
 type, portnumber, and other specifics.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/procinfo-shortdesc.xml

@@ -6,10 +6,8 @@
 usage and IRQ numbers, from the <filename>/proc</filename>
 directory and formats this data in a meaningful way.</para>
 
-<para>Procinfo installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>lsdev, procinfo and socklist</para></sect3>
+<para><emphasis>Installed programs</emphasis>: lsdev, procinfo and
+socklist</para>
 
 </sect2>
 

appendixa/procps-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &procps-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>free</command> reports the amount of free and used memory
 in the system, both physical and swap memory.</para>
@@ -44,14 +40,8 @@ where and since when.</para>
 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>
-
 <para><command>libproc</command> contains the functions used by most
 programs in this package.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/procps-shortdesc.xml

@@ -6,14 +6,10 @@
 halt system processes. Procps gathers information about
 processes via the <filename>/proc</filename> directory.</para>
 
-<para>Procps installs the following:</para>
+<para><emphasis>Installed programs</emphasis>: free, kill, oldps, pgrep,
+pkill, ps, skill, snice, sysctl, tload, top, vmstat, w and watch</para>
 
-<sect3><title>Program Files</title>
-<para>free, kill, oldps, pgrep, pkill, ps, skill, snice, sysctl, tload, top, 
-vmstat, w and watch</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libproc.so</para></sect3>
+<para><emphasis>Installed library</emphasis>: libproc.so</para>
 
 </sect2>
 

appendixa/psmisc-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &psmisc-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>fuser</command> reports the PIDs of processes that use
 the given files or filesystems.</para>
@@ -17,7 +13,5 @@ to all processes running any of the given commands.</para>
 
 <para><command>pstree</command> displays running processes as a tree.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/psmisc-shortdesc.xml

@@ -5,10 +5,7 @@
 <para>The Psmisc package contains three programs which help
 manage the <filename>/proc</filename> directory.</para>
 
-<para>Psmisc installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>fuser, killall and pstree</para></sect3>
+<para><emphasis>Installed programs</emphasis>: fuser, killall and pstree</para>
 
 </sect2>
 

appendixa/sed-desc.xml

@@ -1,15 +1,9 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Description</title>
-
-<para>(Last checked against version &sed-contversion;.)</para>
-
-<sect3><title>Program file description</title>
+<sect2><title>Short description</title>
 
 <para><command>sed</command> is used to filter and transform text files
 in a single pass.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/sed-shortdesc.xml

@@ -6,10 +6,7 @@
 transformations on an input stream (a file or input from a
 pipeline).</para>
 
-<para>Sed installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>sed</para></sect3>
+<para><emphasis>Installed program</emphasis>: sed</para>
 
 </sect2>
 

appendixa/shadowpwd-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &shadow-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>chage</command> is used to change the maximum number of
 days between obligatory password changes.</para>
@@ -100,16 +96,10 @@ files.</para>
 <filename>/etc/passwd</filename> or <filename>/etc/shadow</filename>
 files.</para>
 
-</sect3>
-
-<sect3><title>Library file descriptions</title>
-
 <para><command>libmisc</command>...</para>
 
 <para><command>libshadow</command> contains functions used by most
 programs in this package.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/shadowpwd-shortdesc.xml

@@ -5,13 +5,10 @@
 <para>The Shadow package was created to strengthen the security
 of system passwords.</para>
 
-<para>Shadow installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>chage, chfn, chpasswd, chsh, dpasswd, expiry, faillog, gpasswd, 
-groupadd, groupdel, groupmod, groups, grpck, grpconv, grpunconv, lastlog,
-login, logoutd, mkpasswd, newgrp, newusers, passwd, pwck, pwconv, pwunconv,
-sg (link to newgrp), useradd, userdel, usermod, vigr (link to vipw) and
-vipw</para></sect3>
+<para><emphasis>Installed programs</emphasis>: chage, chfn, chpasswd, chsh,
+dpasswd, expiry, faillog, gpasswd, groupadd, groupdel, groupmod, groups, grpck,
+grpconv, grpunconv, lastlog, login, logoutd, mkpasswd, newgrp, newusers,
+passwd, pwck, pwconv, pwunconv, sg (link to newgrp), useradd, userdel, usermod,
+vigr (link to vipw) and vipw</para>
 
 </sect2>

appendixa/sysklogd-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &sysklogd-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>klogd</command> is a system daemon for intercepting and
 logging kernel messages.</para>
@@ -14,7 +10,5 @@ offer for logging. Every logged message contains at least a date stamp and a
 hostname, and normally the program's name too, but that depends on how
 trusting the logging daemon is told to be.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/sysklogd-shortdesc.xml

@@ -5,10 +5,7 @@
 <para>The Sysklogd package contains programs for recording
 system log messages, such as those reported by the kernel.</para>
 
-<para>Sysklogd installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>klogd and syslogd</para></sect3>
+<para><emphasis>Installed programs</emphasis>: klogd and syslogd</para>
 
 </sect2>
 

appendixa/sysvinit-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &sysvinit-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>halt</command> normally invokes shutdown with the -h flag,
 except when already in runlevel 0, then it tells the kernel to halt the system.
@@ -54,7 +50,5 @@ file in a friendlier format.</para>
 
 <para><command>wall</command> writes a message to all logged-in users.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/sysvinit-shortdesc.xml

@@ -5,13 +5,10 @@
 <para>The Sysvinit package contains programs to control the
 startup, running and shutdown of all other programs.</para>
 
-<para>Sysvinit installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>halt, init, killall5, last, lastb (link to last), mesg, pidof
-(link to killall5), poweroff (link to halt), reboot (link to halt), 
-runlevel, shutdown, sulogin, telinit (link to init), utmpdump and
-wall</para></sect3>
+<para><emphasis>Installed programs</emphasis>: halt, init, killall5, last,
+lastb (link to last), mesg, pidof (link to killall5), poweroff (link to halt),
+reboot (link to halt), runlevel, shutdown, sulogin, telinit (link to init),
+utmpdump and wall</para>
 
 </sect2>
 

appendixa/tar-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &tar-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>rmt</command> is used to remotely manipulate a magnetic
 tape drive, through an interprocess communication connection.</para>
@@ -12,7 +8,5 @@ tape drive, through an interprocess communication connection.</para>
 <para><command>tar</command> is used to create and extract files from
 archives, also known as tarballs.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/tar-shortdesc.xml

@@ -5,9 +5,6 @@
 <para>Tar is an archiving program designed to store and extract
 files from an archive file known as a tar file.</para>
 
-<para>Tar installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>rmt and tar</para></sect3>
+<para><emphasis>Installed programs</emphasis>: rmt and tar</para>
 
 </sect2>

appendixa/tcl-desc.xml

@@ -1,8 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &tcl-contversion;.)</para>
+<sect2><title>Short description</title>
 
 <para><command>tclsh</command> is the Tcl command shell.</para>
 

appendixa/tcl-shortdesc.xml

@@ -4,14 +4,9 @@
 
 <para>The Tcl package contains the Tool Command Language.</para>
 
-<para>Tcl installs the following files:</para>
+<para><emphasis>Installed program</emphasis>: tclsh</para>
 
-<sect3><title>Program Files</title>
-
-<para>tclsh</para></sect3>
-
-<sect3><title>Library Files</title>
-<para>libtcl8.4.so</para></sect3>
+<para><emphasis>Installed library</emphasis>: libtcl8.4.so</para>
 
 </sect2>
 

appendixa/texinfo-desc.xml

@@ -1,10 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
-
-<para>(Last checked against version &texinfo-contversion;.)</para>
-
-<sect3><title>Program file descriptions</title>
+<sect2><title>Short descriptions</title>
 
 <para><command>info</command> is used to read Info documents. Info
 documents are a bit like man pages, but often go much deeper than just
@@ -24,7 +20,5 @@ document into a device-independent file that can be printed.</para>
 
 <para><command>texindex</command> is used to sort Texinfo index files.</para>
 
-</sect3>
-
 </sect2>
 

appendixa/texinfo-shortdesc.xml

@@ -6,10 +6,7 @@
 writing and converting Info documents, which provide system
 documentation.</para>
 
-<para>Texinfo installs the following:</para>
-
-<sect3><title>Program Files</title>
-<para>info, infokey, install-info, makeinfo, texi2dvi and
-texindex</para></sect3>
+<para><emphasis>Installed programs</emphasis>: info, infokey, install-info,
+makeinfo, texi2dvi and texindex</para>
 
 </sect2>