Moving stuff from appendix A to chapter 6.

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

52 files changed, 408 insertions, 109 deletions

diff --git a/chapter06/autoconf.xml b/chapter06/autoconf.xml
index 17bd6775e..315936118 100644
--- a/chapter06/autoconf.xml
+++ b/chapter06/autoconf.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-autoconf">
+<sect1 id="ch06-autoconf" xreflabel="Autoconf">
 <title>Installing Autoconf-&autoconf-version;</title>
 <?dbhtml filename="autoconf.html" dir="chapter06"?>
 
+<para>The Autoconf package contains programs for producing shell scripts that
+can automatically configure source code.</para>
+
 <screen>Estimated build time:           &autoconf-time;
 Estimated required disk space:  &autoconf-compsize;</screen>
 
-&aa-autoconf-shortdesc;
+&aa-autoconf-down;
 &aa-autoconf-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -36,5 +39,8 @@ so:</para>
 
 </sect2>
 
+&aa-autoconf-shortdesc;
+&aa-autoconf-desc;
+
 </sect1>
 
diff --git a/chapter06/automake.xml b/chapter06/automake.xml
index db73750e9..cf7f3a294 100644
--- a/chapter06/automake.xml
+++ b/chapter06/automake.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-automake">
+<sect1 id="ch06-automake" xreflabel="Automake">
 <title>Installing Automake-&automake-version;</title>
 <?dbhtml filename="automake.html" dir="chapter06"?>
 
+<para>The Automake package contains programs for generating Makefiles for use
+with Autoconf.</para>
+
 <screen>Estimated build time:           &automake-time;
 Estimated required disk space:  &automake-compsize;</screen>
 
-&aa-automake-shortdesc;
+&aa-automake-down;
 &aa-automake-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -37,5 +40,8 @@ so:</para>
 
 </sect2>
 
+&aa-automake-shortdesc;
+&aa-automake-desc;
+
 </sect1>
 
diff --git a/chapter06/bash.xml b/chapter06/bash.xml
index c2703142a..b0c6611eb 100644
--- a/chapter06/bash.xml
+++ b/chapter06/bash.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-bash">
+<sect1 id="ch06-bash" xreflabel="Bash">
 <title>Installing Bash-&bash-version;</title>
 <?dbhtml filename="bash.html" dir="chapter06"?>
 
+<para>The Bash package contains the Bourne-Again SHell.</para>
+
 <screen>Estimated build time:           &bash-time;
 Estimated required disk space:  &bash-compsize;</screen>
 
-&aa-bash-shortdesc;
+&aa-bash-down;
 &aa-bash-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -43,5 +45,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-bash-shortdesc;
+&aa-bash-desc;
+
 </sect1>
 
diff --git a/chapter06/binutils.xml b/chapter06/binutils.xml
index 743e7358b..11e7226c5 100644
--- a/chapter06/binutils.xml
+++ b/chapter06/binutils.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-binutils">
+<sect1 id="ch06-binutils" xreflabel="Binutils">
 <title>Installing Binutils-&binutils-version;</title>
 <?dbhtml filename="binutils.html" dir="chapter06"?>
 
+<para>The Binutils package contains a linker, an assembler, and other tools for
+handling object files.</para>
+
 <screen>Estimated build time:           &binutils-time;
 Estimated required disk space:  &binutils-compsize;</screen>
 
-&aa-binutils-shortdesc;
+&aa-binutils-down;
 &aa-binutils-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -80,5 +83,8 @@ some packages:</para>
 
 </sect2>
 
+&aa-binutils-shortdesc;
+&aa-binutils-desc;
+
 </sect1>
 
diff --git a/chapter06/bison.xml b/chapter06/bison.xml
index 5d525b96f..17e298523 100644
--- a/chapter06/bison.xml
+++ b/chapter06/bison.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-bison">
+<sect1 id="ch06-bison" xreflabel="Bison">
 <title>Installing Bison-&bison-version;</title>
 <?dbhtml filename="bison.html" dir="chapter06"?>
 
+<para>The Bison package contains a parser generator.</para>
+
 <screen>Estimated build time:           &bison-time;
 Estimated required disk space:  &bison-compsize;</screen>
 
-&aa-bison-shortdesc;
+&aa-bison-down;
 &aa-bison-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -38,5 +40,8 @@ following command will do so (and takes a long time):</para>
 
 </sect2>
 
+&aa-bison-shortdesc;
+&aa-bison-desc;
+
 </sect1>
 
diff --git a/chapter06/bootscripts.xml b/chapter06/bootscripts.xml
index 504b4ce4c..fe9b32d83 100644
--- a/chapter06/bootscripts.xml
+++ b/chapter06/bootscripts.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-lfs-bootscripts">
+<sect1 id="ch06-lfs-bootscripts" xreflabel="Bootscripts">
 <title>Installing LFS-Bootscripts-&bootscripts-version;</title>
 <?dbhtml filename="bootscripts.html" dir="chapter06"?>
 
+<para>The LFS-Bootscripts package contains a set of bootscripts.</para>
+
 <screen>Estimated build time:           &bootscripts-time;
 Estimated required disk space:  &bootscripts-compsize;</screen>
 
-&aa-bootscripts-shortdesc;
+&aa-bootscripts-down;
 &aa-bootscripts-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -33,5 +35,8 @@ skip the next chapter when you arrive at it and move on to
 
 </sect2>
 
+&aa-bootscripts-shortdesc;
+&aa-bootscripts-desc;
+
 </sect1>
 
diff --git a/chapter06/bzip2.xml b/chapter06/bzip2.xml
index 6b1c4f695..058a0e6ee 100644
--- a/chapter06/bzip2.xml
+++ b/chapter06/bzip2.xml
@@ -1,11 +1,15 @@
-<sect1 id="ch06-bzip2">
+<sect1 id="ch06-bzip2" xreflabel="Bzip2">
 <title>Installing Bzip2-&bzip2-version;</title>
 <?dbhtml filename="bzip2.html" dir="chapter06"?>
 
+<para>The Bzip2 package contains programs for compressing and decompressing
+files. On text files they achieve a much better compression than the
+traditional <userinput>gzip</userinput>.</para>
+
 <screen>Estimated build time:           &bzip2-time;
 Estimated required disk space:  &bzip2-compsize;</screen>
 
-&aa-bzip2-shortdesc;
+&aa-bzip2-down;
 &aa-bzip2-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -46,5 +50,8 @@ ln -s bzip2 /bin/bzcat</userinput></screen>
 
 </sect2>
 
+&aa-bzip2-shortdesc;
+&aa-bzip2-desc;
+
 </sect1>
 
diff --git a/chapter06/chapter06.xml b/chapter06/chapter06.xml
index 300f41ab6..0ea46cf1b 100644
--- a/chapter06/chapter06.xml
+++ b/chapter06/chapter06.xml
@@ -20,6 +20,12 @@ Although we agree with that, we nevertheless choose to give the
 full instructions for each and every package, simply to minimize
 the possibilities for mistakes.</para>
 
+<para>The key to learning what makes a Linux system work is to know
+what each package is used for and why the user (or the system) needs it.
+For this purpose for every installed package a summary of its content is
+given followed by concise descriptions of each program and library it
+installed.</para>
+
 <para>If you plan to use compiler optimizations in this chapter, take a look at
 the optimization hint at <ulink url="&hints-root;optimization.txt"/>. Compiler
 optimizations can make a program run slightly faster, but they may also cause
diff --git a/chapter06/coreutils.xml b/chapter06/coreutils.xml
index cbddb98f0..9ceb62437 100644
--- a/chapter06/coreutils.xml
+++ b/chapter06/coreutils.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-coreutils">
+<sect1 id="ch06-coreutils" xreflabel="Coreutils">
 <title>Installing Coreutils-&coreutils-version;</title>
 <?dbhtml filename="coreutils.html" dir="chapter06"?>
 
+<para>The Coreutils package contains utilities for showing and setting the
+basic system characteristics.</para>
+
 <screen>Estimated build time:           &coreutils-time;
 Estimated required disk space:  &coreutils-compsize;</screen>
 
-&aa-coreutils-shortdesc;
+&aa-coreutils-down;
 &aa-coreutils-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -91,5 +94,8 @@ ln -s ../../bin/install /usr/bin</userinput></screen>
 
 </sect2>
 
+&aa-coreutils-shortdesc;
+&aa-coreutils-desc;
+
 </sect1>
 
diff --git a/chapter06/diffutils.xml b/chapter06/diffutils.xml
index 321081944..9222ac3d6 100644
--- a/chapter06/diffutils.xml
+++ b/chapter06/diffutils.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-diffutils">
+<sect1 id="ch06-diffutils" xreflabel="Diffutils">
 <title>Installing Diffutils-&diffutils-version;</title>
 <?dbhtml filename="diffutils.html" dir="chapter06"?>
 
+<para>The Diffutils package contains programs that show the differences
+between files or directories.</para>
+
 <screen>Estimated build time:           &diffutils-time;
 Estimated required disk space:  &diffutils-compsize;</screen>
 
-&aa-diffutils-shortdesc;
+&aa-diffutils-down;
 &aa-diffutils-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -27,5 +30,8 @@ Estimated required disk space:  &diffutils-compsize;</screen>
 
 </sect2>
 
+&aa-diffutils-shortdesc;
+&aa-diffutils-desc;
+
 </sect1>
 
diff --git a/chapter06/e2fsprogs.xml b/chapter06/e2fsprogs.xml
index 6b4341b30..93f58ba04 100644
--- a/chapter06/e2fsprogs.xml
+++ b/chapter06/e2fsprogs.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-e2fsprogs">
+<sect1 id="ch06-e2fsprogs" xreflabel="E2fsprogs">
 <title>Installing E2fsprogs-&e2fsprogs-version;</title>
 <?dbhtml filename="e2fsprogs.html" dir="chapter06"?>
 
+<para>The E2fsprogs package contains the utilities for handling the ext2
+filesystem. It also supports the ext3 journaling filesystem.</para>
+
 <screen>Estimated build time:           &e2fsprogs-time;
 Estimated required disk space:  &e2fsprogs-compsize;</screen>
 
-&aa-e2fsprogs-shortdesc;
+&aa-e2fsprogs-down;
 &aa-e2fsprogs-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -63,5 +66,8 @@ following command will do so:</para>
 </sect2>
 
 
+&aa-e2fsprogs-shortdesc;
+&aa-e2fsprogs-desc;
+
 </sect1>
 
diff --git a/chapter06/ed.xml b/chapter06/ed.xml
index dd1b7ebc4..489571e20 100644
--- a/chapter06/ed.xml
+++ b/chapter06/ed.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-ed">
+<sect1 id="ch06-ed" xreflabel="Ed">
 <title>Installing Ed-&ed-version;</title>
 <?dbhtml filename="ed.html" dir="chapter06"?>
 
+<para>The Ed package contains a spartan line editor.</para>
+
 <screen>Estimated build time:           &ed-time;
 Estimated required disk space:  &ed-compsize;</screen>
 
-&aa-ed-shortdesc;
+&aa-ed-down;
 &aa-ed-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -58,5 +60,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-ed-shortdesc;
+&aa-ed-desc;
+
 </sect1>
 
diff --git a/chapter06/file.xml b/chapter06/file.xml
index d21b96286..ad992f8a6 100644
--- a/chapter06/file.xml
+++ b/chapter06/file.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-file">
+<sect1 id="ch06-file" xreflabel="File">
 <title>Installing File-&file-version;</title>
 <?dbhtml filename="file.html" dir="chapter06"?>
 
+<para>The File package contains a utility for determining the type of files.</para>
+
 <screen>Estimated build time:           &file-time;
 Estimated required disk space:  &file-compsize;</screen>
 
-&aa-file-shortdesc;
+&aa-file-down;
 &aa-file-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -27,5 +29,8 @@ Estimated required disk space:  &file-compsize;</screen>
 
 </sect2>
 
+&aa-file-shortdesc;
+&aa-file-desc;
+
 </sect1>
 
diff --git a/chapter06/findutils.xml b/chapter06/findutils.xml
index 5c2c0e956..4b3ec4d22 100644
--- a/chapter06/findutils.xml
+++ b/chapter06/findutils.xml
@@ -1,11 +1,15 @@
-<sect1 id="ch06-findutils">
+<sect1 id="ch06-findutils" xreflabel="Findutils">
 <title>Installing Findutils-&findutils-version;</title>
 <?dbhtml filename="findutils.html" dir="chapter06"?>
 
+<para>The Findutils package contains programs to find files. The finding is
+done either by doing a live recursive search through a directory tree, or by
+consulting a previously set up database.</para>
+
 <screen>Estimated build time:           &findutils-time;
 Estimated required disk space:  &findutils-compsize;</screen>
 
-&aa-findutils-shortdesc;
+&aa-findutils-down;
 &aa-findutils-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -39,5 +43,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-findutils-shortdesc;
+&aa-findutils-desc;
+
 </sect1>
 
diff --git a/chapter06/flex.xml b/chapter06/flex.xml
index d202df991..e4e8c51b1 100644
--- a/chapter06/flex.xml
+++ b/chapter06/flex.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-flex">
+<sect1 id="ch06-flex" xreflabel="Flex">
 <title>Installing Flex-&flex-version;</title>
 <?dbhtml filename="flex.html" dir="chapter06"?>
 
+<para>The Flex package contains a utility for generating programs that
+recognize patterns in text.</para>
+
 <screen>Estimated build time:           &flex-time;
 Estimated required disk space:  &flex-compsize;</screen>
 
-&aa-flex-shortdesc;
+&aa-flex-down;
 &aa-flex-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -53,5 +56,8 @@ chmod 755 /usr/bin/lex</userinput></screen>
 
 </sect2>
 
+&aa-flex-shortdesc;
+&aa-flex-desc;
+
 </sect1>
 
diff --git a/chapter06/gawk.xml b/chapter06/gawk.xml
index 1bba52e53..cd6755d04 100644
--- a/chapter06/gawk.xml
+++ b/chapter06/gawk.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-gawk">
+<sect1 id="ch06-gawk" xreflabel="Gawk">
 <title>Installing Gawk-&gawk-version;</title>
 <?dbhtml filename="gawk.html" dir="chapter06"?>
 
+<para>The Gawk package contains programs for manipulating text files.</para>
+
 <screen>Estimated build time:           &gawk-time;
 Estimated required disk space:  &gawk-compsize;</screen>
 
-&aa-gawk-shortdesc;
+&aa-gawk-down;
 &aa-gawk-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -33,5 +35,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-gawk-shortdesc;
+&aa-gawk-desc;
+
 </sect1>
 
diff --git a/chapter06/gcc-2953.xml b/chapter06/gcc-2953.xml
index 5071ad4ce..4e967285f 100644
--- a/chapter06/gcc-2953.xml
+++ b/chapter06/gcc-2953.xml
@@ -5,6 +5,16 @@
 <screen>Estimated build time:           &gcc-2953-time;
 Estimated required disk space:  &gcc-2953-compsize;</screen>
 
+<sect2><title></title>
+<literallayout>Official download location for GCC-2 (&gcc-2953-version;): 
+<ulink url="ftp://ftp.gnu.org/pub/gnu/gcc/"/>
+And for the GCC-2 Patch:
+<ulink url="&patches-root;&gcc-2953-patch;"/>
+And for the GCC-2 No-Fixincludes Patch:
+<ulink url="&patches-root;&gcc-2953-no-fixinc-patch;"/>
+And for the GCC-2 Return-Type Patch:
+<ulink url="&patches-root;&gcc-2953-returntype-fix-patch;"/></literallayout>
+</sect2>
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
diff --git a/chapter06/gcc.xml b/chapter06/gcc.xml
index 2c68102dd..db2d3ab1b 100644
--- a/chapter06/gcc.xml
+++ b/chapter06/gcc.xml
@@ -1,11 +1,18 @@
-<sect1 id="ch06-gcc">
+<sect1 id="ch06-gcc" xreflabel="GCC">
 <title>Installing GCC-&gcc-version;</title>
 <?dbhtml filename="gcc.html" dir="chapter06"?>
 
+<para>The GCC package contains the GNU compiler collection, among them
+the C and C++ compilers.</para>
+
 <screen>Estimated build time:           &gcc-time;
 Estimated required disk space:  &gcc-compsize;</screen>
 
-&aa-gcc-shortdesc;
+<literallayout>Official download location for GCC (&gcc-version;): 
+<ulink url="ftp://ftp.gnu.org/pub/gnu/gcc/"/>
+And for the GCC No-Fixincludes Patch:
+<ulink url="&patches-root;&gcc-nofixincludes-patch;"/></literallayout>
+
 &aa-gcc-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -92,5 +99,8 @@ Chapter 5.</para></note>
 
 </sect2>
 
+&aa-gcc-shortdesc;
+&aa-gcc-desc;
+
 </sect1>
 
diff --git a/chapter06/gettext.xml b/chapter06/gettext.xml
index 9858bbd47..e8ae88eca 100644
--- a/chapter06/gettext.xml
+++ b/chapter06/gettext.xml
@@ -1,11 +1,15 @@
-<sect1 id="ch06-gettext">
+<sect1 id="ch06-gettext" xreflabel="Gettext">
 <title>Installing Gettext-&gettext-version;</title>
 <?dbhtml filename="gettext.html" dir="chapter06"?>
 
+<para>The Gettext package contains utilities for internationalization and
+localization. These allow programs to be compiled with Native Language Support
+(NLS), enabling them to output messages in the user's native language.</para>
+
 <screen>Estimated build time:           &gettext-time;
 Estimated required disk space:  &gettext-compsize;</screen>
 
-&aa-gettext-shortdesc;
+&aa-gettext-down;
 &aa-gettext-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -37,5 +41,8 @@ so:</para>
 
 </sect2>
 
+&aa-gettext-shortdesc;
+&aa-gettext-desc;
+
 </sect1>
 
diff --git a/chapter06/glibc.xml b/chapter06/glibc.xml
index 45c90caee..5bb78e198 100644
--- a/chapter06/glibc.xml
+++ b/chapter06/glibc.xml
@@ -1,17 +1,22 @@
-<sect1 id="ch06-glibc">
+<sect1 id="ch06-glibc" xreflabel="Glibc">
 <title>Installing Glibc-&glibc-version;</title>
 <?dbhtml filename="glibc.html" dir="chapter06"?>
 
+<para>The Glibc package contains the main C library. This library provides all
+the basic routines for allocating memory, searching directories, opening and
+closing files, reading and writing them, string handling, pattern matching,
+arithmetic, and so on.</para>
+
 <screen>Estimated build time:           &glibc-time;
 Estimated required disk space:  &glibc-compsize;</screen>
 
-&aa-glibc-shortdesc;
+&aa-glibc-down;
 &aa-glibc-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
 <sect2>
-<title>Glibc installation</title>
+<title>Installation of Glibc</title>
 
 <para>The Glibc build system is very well self-contained and will install
 perfectly, even though our compiler specs file and linker are still pointing
@@ -120,6 +125,11 @@ localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen>
 <screen><userinput>make -C ../&glibc-dir;/linuxthreads/man install</userinput></screen>
 
 </sect2>
+
 &c6-cf-glibc;
+
+&aa-glibc-shortdesc;
+&aa-glibc-desc;
+
 </sect1>
 
diff --git a/chapter06/grep.xml b/chapter06/grep.xml
index a68e7a271..771b21deb 100644
--- a/chapter06/grep.xml
+++ b/chapter06/grep.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-grep">
+<sect1 id="ch06-grep" xreflabel="Grep">
 <title>Installing Grep-&grep-version;</title>
 <?dbhtml filename="grep.html" dir="chapter06"?>
 
+<para>The Grep package contains programs for searching through files.</para>
+
 <screen>Estimated build time:           &grep-time;
 Estimated required disk space:  &grep-compsize;</screen>
 
-&aa-grep-shortdesc;
+&aa-grep-down;
 &aa-grep-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -34,5 +36,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-grep-shortdesc;
+&aa-grep-desc;
+
 </sect1>
 
diff --git a/chapter06/groff.xml b/chapter06/groff.xml
index de9cc25d3..3985420a3 100644
--- a/chapter06/groff.xml
+++ b/chapter06/groff.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-groff">
+<sect1 id="ch06-groff" xreflabel="Groff">
 <title>Installing Groff-&groff-version;</title>
 <?dbhtml filename="groff.html" dir="chapter06"?>
 
+<para>The Groff package contains programs for processing and formatting text.</para>
+
 <screen>Estimated build time:           &groff-time;
 Estimated required disk space:  &groff-compsize;</screen>
 
-&aa-groff-shortdesc;
+&aa-groff-down;
 &aa-groff-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -39,5 +41,8 @@ ln -s tbl /usr/bin/gtbl</userinput></screen>
 
 </sect2>
 
+&aa-groff-shortdesc;
+&aa-groff-desc;
+
 </sect1>
 
diff --git a/chapter06/grub.xml b/chapter06/grub.xml
index 29bf07713..cf31362e2 100644
--- a/chapter06/grub.xml
+++ b/chapter06/grub.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-grub">
+<sect1 id="ch06-grub" xreflabel="Grub">
 <title>Installing Grub-&grub-version;</title>
 <?dbhtml filename="grub.html" dir="chapter06"?>
 
+<para>The Grub package contains the GRand Unified Bootloader.</para>
+
 <screen>Estimated build time:           &grub-time;
 Estimated required disk space:  &grub-compsize;</screen>
 
-&aa-grub-shortdesc;
+&aa-grub-down;
 &aa-grub-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -49,5 +51,8 @@ and/or <filename>reiserfs_stage1_5</filename> files.</para>
 
 </sect2>
 
+&aa-grub-shortdesc;
+&aa-grub-desc;
+
 </sect1>
 
diff --git a/chapter06/gzip.xml b/chapter06/gzip.xml
index 7e097a06e..295c4a6c8 100644
--- a/chapter06/gzip.xml
+++ b/chapter06/gzip.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-gzip">
+<sect1 id="ch06-gzip" xreflabel="Gzip">
 <title>Installing Gzip-&gzip-version;</title>
 <?dbhtml filename="gzip.html" dir="chapter06"?>
 
+<para>The Gzip package contains programs for compressing and decompressing
+files.</para>
+
 <screen>Estimated build time:           &gzip-time;
 Estimated required disk space:  &gzip-compsize;</screen>
 
-&aa-gzip-shortdesc;
+&aa-gzip-down;
 &aa-gzip-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -44,5 +47,8 @@ ln -s gunzip /bin/uncompress</userinput></screen>
 
 </sect2>
 
+&aa-gzip-shortdesc;
+&aa-gzip-desc;
+
 </sect1>
 
diff --git a/chapter06/inetutils.xml b/chapter06/inetutils.xml
index 9fab9e5f4..c15d82aab 100644
--- a/chapter06/inetutils.xml
+++ b/chapter06/inetutils.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-inetutils">
+<sect1 id="ch06-inetutils" xreflabel="Inetutils">
 <title>Installing Inetutils-&inetutils-version;</title>
 <?dbhtml filename="inetutils.html" dir="chapter06"?>
 
+<para>The Inetutils package contains programs for basic networking.</para>
+
 <screen>Estimated build time:           &inetutils-time;
 Estimated required disk space:  &inetutils-compsize;</screen>
 
-&aa-inetutils-shortdesc;
+&aa-inetutils-down;
 &aa-inetutils-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -65,5 +67,8 @@ replacements are available for many of these servers.</para></listitem>
 
 </sect2>
 
+&aa-inetutils-shortdesc;
+&aa-inetutils-desc;
+
 </sect1>
 
diff --git a/chapter06/kbd.xml b/chapter06/kbd.xml
index 0f4894751..bb39ab2e3 100644
--- a/chapter06/kbd.xml
+++ b/chapter06/kbd.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-kbd">
+<sect1 id="ch06-kbd" xreflabel="Kbd">
 <title>Installing Kbd-&kbd-version;</title>
 <?dbhtml filename="kbd.html" dir="chapter06"?>
 
+<para>The Kbd package contains keytable files and keyboard utilities.</para>
+
 <screen>Estimated build time:           &kbd-time;
 Estimated required disk space:  &kbd-compsize;</screen>
 
-&aa-kbd-shortdesc;
+&aa-kbd-down;
 &aa-kbd-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -35,5 +37,8 @@ not installed. First enable the compilation of these utilities:</para>
 
 &c6-cf-keyboard;
 
+&aa-kbd-shortdesc;
+&aa-kbd-desc;
+
 </sect1>
 
diff --git a/chapter06/kernel.xml b/chapter06/kernel.xml
index 3e3b50093..91f4cbaee 100644
--- a/chapter06/kernel.xml
+++ b/chapter06/kernel.xml
@@ -5,9 +5,6 @@
 <screen>Estimated build time:           &kernel-time-headers;
 Estimated required disk space:  &kernel-compsize-headers;</screen>
 
-&aa-kernel-shortdesc;
-&aa-kernel-dep;
-
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
 <sect2>
diff --git a/chapter06/less.xml b/chapter06/less.xml
index 0508af478..fd6bac9bc 100644
--- a/chapter06/less.xml
+++ b/chapter06/less.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-less">
+<sect1 id="ch06-less" xreflabel="Less">
 <title>Installing Less-&less-version;</title>
 <?dbhtml filename="less.html" dir="chapter06"?>
 
+<para>The Less package contains a text file viewer.</para>
+
 <screen>Estimated build time:           &less-time;
 Estimated required disk space:  &less-compsize;</screen>
 
-&aa-less-shortdesc;
+&aa-less-down;
 &aa-less-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -35,5 +37,8 @@ configuration files.</para></listitem>
 
 </sect2>
 
+&aa-less-shortdesc;
+&aa-less-desc;
+
 </sect1>
 
diff --git a/chapter06/lfs-utils.xml b/chapter06/lfs-utils.xml
index 25a40748d..282a79fc6 100644
--- a/chapter06/lfs-utils.xml
+++ b/chapter06/lfs-utils.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-lfs-utils">
+<sect1 id="ch06-lfs-utils" xreflabel="Lfs-Utils">
 <title>Installing Lfs-Utils-&lfs-utils-version;</title>
 <?dbhtml filename="lfs-utils.html" dir="chapter06"?>
 
+<para>The Lfs-Utils package contains a few helper files.</para>
+
 <screen>Estimated build time:           &lfs-utils-time;
 Estimated required disk space:  &lfs-utils-compsize;</screen>
 
-&aa-lfs-utils-shortdesc;
+&aa-lfs-utils-down;
 &aa-lfs-utils-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -21,7 +23,7 @@ Estimated required disk space:  &lfs-utils-compsize;</screen>
 
 <itemizedlist>
 <listitem><para><userinput>--with-libc</userinput>: This causes the
-<filename>mktemp</filename> program to use the <emphasis>mkstemp</emphasis>
+<userinput>mktemp</userinput> program to use the <emphasis>mkstemp</emphasis>
 and <emphasis>mkdtemp</emphasis> functions from the system C
 library.</para></listitem>
 </itemizedlist>
@@ -45,5 +47,8 @@ does the same for protocol numbers.</para>
 
 </sect2>
 
+&aa-lfs-utils-shortdesc;
+&aa-lfs-utils-desc;
+
 </sect1>
 
diff --git a/chapter06/libtool.xml b/chapter06/libtool.xml
index 9e9f9457f..112107ee3 100644
--- a/chapter06/libtool.xml
+++ b/chapter06/libtool.xml
@@ -1,11 +1,15 @@
-<sect1 id="ch06-libtool">
+<sect1 id="ch06-libtool" xreflabel="Libtool">
 <title>Installing Libtool-&libtool-version;</title>
 <?dbhtml filename="libtool.html" dir="chapter06"?>
 
+<para>The Libtool package contains the GNU generic library support script.
+It wraps the complexity of using shared libraries in a consistent, portable
+interface.</para>
+
 <screen>Estimated build time:           &libtool-time;
 Estimated required disk space:  &libtool-compsize;</screen>
 
-&aa-libtool-shortdesc;
+&aa-libtool-down;
 &aa-libtool-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -33,5 +37,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-libtool-shortdesc;
+&aa-libtool-desc;
+
 </sect1>
 
diff --git a/chapter06/m4.xml b/chapter06/m4.xml
index b52647f10..84bfc8400 100644
--- a/chapter06/m4.xml
+++ b/chapter06/m4.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-m4">
+<sect1 id="ch06-m4" xreflabel="M4">
 <title>Installing M4-&m4-version;</title>
 <?dbhtml filename="m4.html" dir="chapter06"?>
 
+<para>The M4 package contains a macro processor.</para>
+
 <screen>Estimated build time:           &m4-time;
 Estimated required disk space:  &m4-compsize;</screen>
 
-&aa-m4-shortdesc;
+&aa-m4-down;
 &aa-m4-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -33,5 +35,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-m4-shortdesc;
+&aa-m4-desc;
+
 </sect1>
 
diff --git a/chapter06/make.xml b/chapter06/make.xml
index f24d53ee3..346a5dc12 100644
--- a/chapter06/make.xml
+++ b/chapter06/make.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-make">
+<sect1 id="ch06-make" xreflabel="Make">
 <title>Installing Make-&make-version;</title>
 <?dbhtml filename="make.html" dir="chapter06"?>
 
+<para>The Make package contains a program for compiling large packages.</para>
+
 <screen>Estimated build time:           &make-time;
 Estimated required disk space:  &make-compsize;</screen>
 
-&aa-make-shortdesc;
+&aa-make-down;
 &aa-make-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -33,5 +35,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-make-shortdesc;
+&aa-make-desc;
+
 </sect1>
 
diff --git a/chapter06/makedev.xml b/chapter06/makedev.xml
index 424d727a8..d48d57cfd 100644
--- a/chapter06/makedev.xml
+++ b/chapter06/makedev.xml
@@ -1,17 +1,19 @@
-<sect1 id="ch06-MAKEDEV">
-<title>Creating devices (Makedev-&makedev-version;)</title>
+<sect1 id="ch06-MAKEDEV" xreflabel="Makedev">
+<title>Creating devices with Makedev-&makedev-version;</title>
 <?dbhtml filename="makedev.html" dir="chapter06"?>
 
+<para>The MAKEDEV package contains a script for making device nodes.</para>
+
 <screen>Estimated build time:           &makedev-time;
 Estimated required disk space:  &makedev-compsize;</screen>
 
-&aa-makedev-shortdesc;
+&aa-makedev-down;
 &aa-makedev-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
 <sect2>
-<title>Creating devices</title>
+<title>Making devices</title>
 
 <para>Note that unpacking the <filename>MAKEDEV-&makedev-version;.bz2</filename>
 file doesn't create a directory for you to <userinput>cd</userinput> into, as
@@ -67,5 +69,8 @@ finally boot into the finished LFS system.</para>
 
 </sect2>
 
+&aa-makedev-shortdesc;
+&aa-makedev-desc;
+
 </sect1>
 
diff --git a/chapter06/man.xml b/chapter06/man.xml
index 05856c34c..a031c5273 100644
--- a/chapter06/man.xml
+++ b/chapter06/man.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-man">
+<sect1 id="ch06-man" xreflabel="Man">
 <title>Installing Man-&man-version;</title>
 <?dbhtml filename="man.html" dir="chapter06"?>
 
+<para>The Man package contains programs for finding and viewing manual pages.</para>
+
 <screen>Estimated build time:           &man-time;
 Estimated required disk space:  &man-compsize;</screen>
 
-&aa-man-shortdesc;
+&aa-man-down;
 &aa-man-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -70,5 +72,8 @@ formatting and compression issues for man pages.</para>
 
 </sect2>
 
+&aa-man-shortdesc;
+&aa-man-desc;
+
 </sect1>
 
diff --git a/chapter06/manpages.xml b/chapter06/manpages.xml
index bb8715bb2..c0f4fc979 100644
--- a/chapter06/manpages.xml
+++ b/chapter06/manpages.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-man-pages">
+<sect1 id="ch06-man-pages" xreflabel="Man-pages">
 <title>Installing Man-pages-&man-pages-version;</title>
 <?dbhtml filename="man-pages.html" dir="chapter06"?>
 
+<para>The Man-pages package contains over 1200 manual pages.</para>
+
 <screen>Estimated build time:           &man-pages-time;
 Estimated required disk space:  &man-pages-compsize;</screen>
 
-&aa-manpages-shortdesc;
+&aa-manpages-down;
 &aa-manpages-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -19,5 +21,8 @@ Estimated required disk space:  &man-pages-compsize;</screen>
 
 </sect2>
 
+&aa-manpages-shortdesc;
+&aa-manpages-desc;
+
 </sect1>
 
diff --git a/chapter06/modutils.xml b/chapter06/modutils.xml
index d5c6708f1..2103a4f19 100644
--- a/chapter06/modutils.xml
+++ b/chapter06/modutils.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-modutils">
+<sect1 id="ch06-modutils" xreflabel="Modutils">
 <title>Installing Modutils-&modutils-version;</title>
 <?dbhtml filename="modutils.html" dir="chapter06"?>
 
+<para>The Modutils package contains programs for handling kernel modules.</para>
+
 <screen>Estimated build time:           &modutils-time;
 Estimated required disk space:  &modutils-compsize;</screen>
 
-&aa-modutils-shortdesc;
+&aa-modutils-down;
 &aa-modutils-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -27,5 +29,8 @@ Estimated required disk space:  &modutils-compsize;</screen>
 
 </sect2>
 
+&aa-modutils-shortdesc;
+&aa-modutils-desc;
+
 </sect1>
 
diff --git a/chapter06/ncurses.xml b/chapter06/ncurses.xml
index 9c194834b..3435c8061 100644
--- a/chapter06/ncurses.xml
+++ b/chapter06/ncurses.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-ncurses">
+<sect1 id="ch06-ncurses" xreflabel="Ncurses">
 <title>Installing Ncurses-&ncurses-version;</title>
 <?dbhtml filename="ncurses.html" dir="chapter06"?>
 
+<para>The Ncurses package contains libraries for the terminal-independent
+handling of character  screens.</para>
+
 <screen>Estimated build time:           &ncurses-time;
 Estimated required disk space:  &ncurses-compsize;</screen>
 
-&aa-ncurses-shortdesc;
+&aa-ncurses-down;
 &aa-ncurses-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -52,5 +55,8 @@ towards non-existing files. Recreate those symlinks:</para>
 ln -sf libncurses.so /usr/lib/libcurses.so</userinput></screen>
 </sect2>
 
+&aa-ncurses-shortdesc;
+&aa-ncurses-desc;
+
 </sect1>
 
diff --git a/chapter06/nettools.xml b/chapter06/nettools.xml
index e4fc358be..e846df1cc 100644
--- a/chapter06/nettools.xml
+++ b/chapter06/nettools.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-net-tools">
+<sect1 id="ch06-net-tools" xreflabel="Net-tools">
 <title>Installing Net-tools-&net-tools-version;</title>
 <?dbhtml filename="net-tools.html" dir="chapter06"?>
 
+<para>The Net-tools package contains programs for basic networking.</para>
+
 <screen>Estimated build time:           &net-tools-time;
 Estimated required disk space:  &net-tools-compsize;</screen>
 
-&aa-nettools-shortdesc;
+&aa-nettools-down;
 &aa-nettools-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -46,5 +48,8 @@ questions generated by <emphasis>make config</emphasis> by running
 
 </sect2>
 
+&aa-nettools-shortdesc;
+&aa-nettools-desc;
+
 </sect1>
 
diff --git a/chapter06/patch.xml b/chapter06/patch.xml
index cc634a8e8..1692c4d70 100644
--- a/chapter06/patch.xml
+++ b/chapter06/patch.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-patch">
+<sect1 id="ch06-patch" xreflabel="Patch">
 <title>Installing Patch-&patch-version;</title>
 <?dbhtml filename="patch.html" dir="chapter06"?>
 
+<para>The Patch package contains a program for modifying files.</para>
+
 <screen>Estimated build time:           &patch-time;
 Estimated required disk space:  &patch-compsize;</screen>
 
-&aa-patch-shortdesc;
+&aa-patch-down;
 &aa-patch-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -30,5 +32,8 @@ needed on the PowerPC platform. On other architectures you can leave it out.</pa
 
 </sect2>
 
+&aa-patch-shortdesc;
+&aa-patch-desc;
+
 </sect1>
 
diff --git a/chapter06/perl.xml b/chapter06/perl.xml
index 7010e5f70..e96ce49d0 100644
--- a/chapter06/perl.xml
+++ b/chapter06/perl.xml
@@ -1,11 +1,15 @@
-<sect1 id="ch06-perl">
+<sect1 id="ch06-perl" xreflabel="Perl">
 <title>Installing Perl-&perl-version;</title>
 <?dbhtml filename="perl.html" dir="chapter06"?>
 
+<para>The Perl package contains the Practical Extraction and Report Language.</para>
+
 <screen>Estimated build time:           &perl-time;
 Estimated required disk space:  &perl-compsize;</screen>
 
-&aa-perl-shortdesc;
+<literallayout>Official download location for Perl (&perl-version;):
+<ulink url="http://www.perl.com/"/></literallayout>
+
 &aa-perl-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -52,5 +56,8 @@ couple of tests to resolve the name <emphasis>localhost</emphasis>:</para>
 
 </sect2>
 
+&aa-perl-shortdesc;
+&aa-perl-desc;
+
 </sect1>
 
diff --git a/chapter06/procinfo.xml b/chapter06/procinfo.xml
index e02b583b6..6cee65215 100644
--- a/chapter06/procinfo.xml
+++ b/chapter06/procinfo.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-procinfo">
+<sect1 id="ch06-procinfo" xreflabel="Procinfo">
 <title>Installing Procinfo-&procinfo-version;</title>
 <?dbhtml filename="procinfo.html" dir="chapter06"?>
 
+<para>The Procinfo package contains programs for displaying system information.</para>
+
 <screen>Estimated build time:           &procinfo-time;
 Estimated required disk space:  &procinfo-compsize;</screen>
 
-&aa-procinfo-shortdesc;
+&aa-procinfo-down;
 &aa-procinfo-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -30,5 +32,8 @@ long-obsolete <filename>libtermcap</filename>.</para></listitem>
 
 </sect2>
 
+&aa-procinfo-shortdesc;
+&aa-procinfo-desc;
+
 </sect1>
 
diff --git a/chapter06/procps.xml b/chapter06/procps.xml
index 9dda8547f..a5e8864d8 100644
--- a/chapter06/procps.xml
+++ b/chapter06/procps.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-procps">
+<sect1 id="ch06-procps" xreflabel="Procps">
 <title>Installing Procps-&procps-version;</title>
 <?dbhtml filename="procps.html" dir="chapter06"?>
 
+<para>The Procps package contains programs for monitoring processes.</para>
+
 <screen>Estimated build time:           &procps-time;
 Estimated required disk space:  &procps-compsize;</screen>
 
-&aa-procps-shortdesc;
+&aa-procps-down;
 &aa-procps-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -27,5 +29,8 @@ Estimated required disk space:  &procps-compsize;</screen>
 
 </sect2>
 
+&aa-procps-shortdesc;
+&aa-procps-desc;
+
 </sect1>
 
diff --git a/chapter06/psmisc.xml b/chapter06/psmisc.xml
index 7438d7cd2..307d0252c 100644
--- a/chapter06/psmisc.xml
+++ b/chapter06/psmisc.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-psmisc">
+<sect1 id="ch06-psmisc" xreflabel="Psmisc">
 <title>Installing Psmisc-&psmisc-version;</title>
 <?dbhtml filename="psmisc.html" dir="chapter06"?>
 
+<para>The Psmisc package contains programs for displaying information on
+processes.</para>
+
 <screen>Estimated build time:           &psmisc-time;
 Estimated required disk space:  &psmisc-compsize;</screen>
 
-&aa-psmisc-shortdesc;
+&aa-psmisc-down;
 &aa-psmisc-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -55,5 +58,8 @@ creating the following symlink:</para>
 
 </sect2>
 
+&aa-psmisc-shortdesc;
+&aa-psmisc-desc;
+
 </sect1>
 
diff --git a/chapter06/sed.xml b/chapter06/sed.xml
index 25f9b488d..2e684a89a 100644
--- a/chapter06/sed.xml
+++ b/chapter06/sed.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-sed">
+<sect1 id="ch06-sed" xreflabel="Sed">
 <title>Installing Sed-&sed-version;</title>
 <?dbhtml filename="sed.html" dir="chapter06"?>
 
+<para>The Sed package contains a stream editor.</para>
+
 <screen>Estimated build time:           &sed-time;
 Estimated required disk space:  &sed-compsize;</screen>
 
-&aa-sed-shortdesc;
+&aa-sed-down;
 &aa-sed-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -33,5 +35,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-sed-shortdesc;
+&aa-sed-desc;
+
 </sect1>
 
diff --git a/chapter06/shadowpwd.xml b/chapter06/shadowpwd.xml
index aeaefac1c..4e8e3aa79 100644
--- a/chapter06/shadowpwd.xml
+++ b/chapter06/shadowpwd.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-shadow">
+<sect1 id="ch06-shadow" xreflabel="Shadow">
 <title>Installing Shadow-&shadow-version;</title>
 <?dbhtml filename="shadow.html" dir="chapter06"?>
 
+<para>The Shadow package contains programs for handling passwords in a secure
+way.</para>
+
 <screen>Estimated build time:           &shadow-time;
 Estimated required disk space:  &shadow-compsize;</screen>
 
-&aa-shadowpwd-shortdesc;
+&aa-shadowpwd-down;
 &aa-shadowpwd-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -121,5 +124,8 @@ installed by Shadow:</para>
 &c6-cf-shadowpwd;
 &c6-cf-password;
 
+&aa-shadowpwd-shortdesc;
+&aa-shadowpwd-desc;
+
 </sect1>
 
diff --git a/chapter06/sysklogd.xml b/chapter06/sysklogd.xml
index 2d8dd4aa9..9a472bf4c 100644
--- a/chapter06/sysklogd.xml
+++ b/chapter06/sysklogd.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-sysklogd">
+<sect1 id="ch06-sysklogd" xreflabel="Sysklogd">
 <title>Installing Sysklogd-&sysklogd-version;</title>
 <?dbhtml filename="sysklogd.html" dir="chapter06"?>
 
+<para>The Sysklogd package contains programs for logging system messages, such
+as those given by the kernel when unusual things happen.</para>
+
 <screen>Estimated build time:           &sysklogd-time;
 Estimated required disk space:  &sysklogd-compsize;</screen>
 
-&aa-sysklogd-shortdesc;
+&aa-sysklogd-down;
 &aa-sysklogd-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -22,6 +25,11 @@ Estimated required disk space:  &sysklogd-compsize;</screen>
 <screen><userinput>make install</userinput></screen>
 
 </sect2>
+
 &c6-cf-sysklogd;
+
+&aa-sysklogd-shortdesc;
+&aa-sysklogd-desc;
+
 </sect1>
 
diff --git a/chapter06/sysvinit.xml b/chapter06/sysvinit.xml
index ced2af4fd..4ff4cf791 100644
--- a/chapter06/sysvinit.xml
+++ b/chapter06/sysvinit.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-sysvinit">
+<sect1 id="ch06-sysvinit" xreflabel="Sysvinit">
 <title>Installing Sysvinit-&sysvinit-version;</title>
 <?dbhtml filename="sysvinit.html" dir="chapter06"?>
 
+<para>The Sysvinit package contains programs for controlling the startup,
+running, and shutdown of your system.</para>
+
 <screen>Estimated build time:           &sysvinit-time;
 Estimated required disk space:  &sysvinit-compsize;</screen>
 
-&aa-sysvinit-shortdesc;
+&aa-sysvinit-down;
 &aa-sysvinit-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -36,6 +39,11 @@ sed 's/Sending processes/&amp; started by init/g' \
 <screen><userinput>make -C src install</userinput></screen>
 
 </sect2>
+
 &c6-cf-sysvinit;
+
+&aa-sysvinit-shortdesc;
+&aa-sysvinit-desc;
+
 </sect1>
 
diff --git a/chapter06/tar.xml b/chapter06/tar.xml
index 2e21fad4f..310411b52 100644
--- a/chapter06/tar.xml
+++ b/chapter06/tar.xml
@@ -1,11 +1,13 @@
-<sect1 id="ch06-tar">
+<sect1 id="ch06-tar" xreflabel="Tar">
 <title>Installing Tar-&tar-version;</title>
 <?dbhtml filename="tar.html" dir="chapter06"?>
 
+<para>The Tar package contains an archiving program.</para>
+
 <screen>Estimated build time:           &tar-time;
 Estimated required disk space:  &tar-compsize;</screen>
 
-&aa-tar-shortdesc;
+&aa-tar-down;
 &aa-tar-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -34,5 +36,8 @@ following command will do so:</para>
 
 </sect2>
 
+&aa-tar-shortdesc;
+&aa-tar-desc;
+
 </sect1>
 
diff --git a/chapter06/texinfo.xml b/chapter06/texinfo.xml
index 152dbb033..1884a7080 100644
--- a/chapter06/texinfo.xml
+++ b/chapter06/texinfo.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-texinfo">
+<sect1 id="ch06-texinfo" xreflabel="Texinfo">
 <title>Installing Texinfo-&texinfo-version;</title>
 <?dbhtml filename="texinfo.html" dir="chapter06"?>
 
+<para>The Texinfo package contains programs for reading, writing, and
+converting Info documents.</para>
+
 <screen>Estimated build time:           &texinfo-time;
 Estimated required disk space:  &texinfo-compsize;</screen>
 
-&aa-texinfo-shortdesc;
+&aa-texinfo-down;
 &aa-texinfo-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -59,5 +62,8 @@ done</userinput></screen>
 
 </sect2>
 
+&aa-texinfo-shortdesc;
+&aa-texinfo-desc;
+
 </sect1>
 
diff --git a/chapter06/utillinux.xml b/chapter06/utillinux.xml
index 62a514511..1ff0bb410 100644
--- a/chapter06/utillinux.xml
+++ b/chapter06/utillinux.xml
@@ -1,11 +1,15 @@
-<sect1 id="ch06-util-linux">
+<sect1 id="ch06-util-linux" xreflabel="Util-linux">
 <title>Installing Util-linux-&util-linux-version;</title>
 <?dbhtml filename="util-linux.html" dir="chapter06"?>
 
+<para>The Util-linux package contains miscellaneous utility programs. Among
+them are utilities for handling filesystems, consoles, partitions, and
+messages.</para>
+
 <screen>Estimated build time:           &util-linux-time;
 Estimated required disk space:  &util-linux-compsize;</screen>
 
-&aa-utillinux-shortdesc;
+&aa-utillinux-down;
 &aa-utillinux-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -55,5 +59,8 @@ installed again.</para></listitem>
 
 </sect2>
 
+&aa-utillinux-shortdesc;
+&aa-utillinux-desc;
+
 </sect1>
 
diff --git a/chapter06/vim.xml b/chapter06/vim.xml
index 4076e4188..06a10aebc 100644
--- a/chapter06/vim.xml
+++ b/chapter06/vim.xml
@@ -1,22 +1,24 @@
-<sect1 id="ch06-vim">
+<sect1 id="ch06-vim" xreflabel="Vim">
 <title>Installing Vim-&vim-version;</title>
 <?dbhtml filename="vim.html" dir="chapter06"?>
 
+<para>The Vim package contains a powerful text editor.</para>
+
 <screen>Estimated build time:           &vim-time;
 Estimated required disk space:  &vim-compsize;</screen>
 
+&aa-vim-down;
+&aa-vim-dep;
+
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
 <sect2>
 <title>Alternatives to Vim</title>
-
 <para>If you prefer another editor -- like Emacs, Joe, or Nano -- to Vim,
 have a look at <ulink url="&blfs-root;view/stable/postlfs/editors.html"/> for
 suggested installation instructions.</para>
-
 </sect2>
 
-&aa-vim-shortdesc;
-&aa-vim-dep;
-
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
 <sect2>
@@ -64,5 +66,8 @@ installed. For more information read the Vim documentation.</para>
 
 &c6-cf-vim;
 
+&aa-vim-shortdesc;
+&aa-vim-desc;
+
 </sect1>
 
diff --git a/chapter06/zlib.xml b/chapter06/zlib.xml
index df823d79b..e0b63e3ec 100644
--- a/chapter06/zlib.xml
+++ b/chapter06/zlib.xml
@@ -1,11 +1,14 @@
-<sect1 id="ch06-zlib">
+<sect1 id="ch06-zlib" xreflabel="Zlib">
 <title>Installing Zlib-&zlib-version;</title>
 <?dbhtml filename="zlib.html" dir="chapter06"?>
 
+<para>The Zlib package contains compression and uncompression routines used by
+some programs.</para>
+
 <screen>Estimated build time:           &zlib-time;
 Estimated required disk space:  &zlib-compsize;</screen>
 
-&aa-zlib-shortdesc;
+&aa-zlib-down;
 &aa-zlib-dep;
 
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
@@ -78,5 +81,8 @@ because we just moved the location of the file it points to:</para>
 
 </sect2>
 
+&aa-zlib-shortdesc;
+&aa-zlib-desc;
+
 </sect1>