clean up short descriptions

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

chapter08/iproute2.xml

@@ -90,7 +90,7 @@ rm -fv man/man8/arpd.8</userinput></screen>
         <seg>bridge, ctstat (link to lnstat), genl, ifcfg, ifstat, ip, lnstat,
         nstat, routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
         and tc</seg>
-        <seg>/etc/iproute2, /usr/lib/tc, and /usr/share/doc/iproute2-&iproute2-version;,
+        <seg>/etc/iproute2, /usr/lib/tc, and /usr/share/doc/iproute2-&iproute2-version;
         </seg>
       </seglistitem>
     </segmentedlist>

chapter08/libelf.xml

@@ -78,14 +78,32 @@ rm /lib/libelf.a</userinput></screen>
 
       <seglistitem>
         <seg>
-          libelf.so
+          libelf.so (symlink) and libelf-&elfutils-version;.so
         </seg>
         <seg>
           /usr/include/elfutils
         </seg>
       </seglistitem>
+
     </segmentedlist>
 
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="libelf">
+        <term><filename class="libraryfile">libelf</filename></term>
+        <listitem>
+          <para>Contains API functions to handle ELF object files</para>
+          <indexterm zone="ch-system-libelf libelf">
+            <primary sortas="c-libelf">libelf</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
   </sect2>
 
 </sect1>

chapter08/libffi.xml

@@ -106,7 +106,7 @@
       <varlistentry id="libffi">
         <term><filename class="libraryfile">libffi</filename></term>
         <listitem>
-          <para>contains the libffi API functions.</para>
+          <para>contains the foreign function interface API functions</para>
           <indexterm zone="ch-system-libffi">
             <primary sortas="c-libffi">libffi</primary>
           </indexterm>

chapter08/m4.xml

@@ -90,7 +90,7 @@ echo "#define _IO_IN_BACKUP 0x100" >> lib/stdio-impl.h</userinput></screen>
           files, running Unix commands, performing integer arithmetic,
           manipulating text, recursion, etc. The <command>m4</command> program
           can be used either as a front-end to a compiler or as a macro processor
-          in its own right.</para>
+          in its own right</para>
           <indexterm zone="ch-system-m4 m4">
             <primary sortas="b-m4">m4</primary>
           </indexterm>

chapter08/ninja.xml

@@ -122,7 +122,7 @@ install -vDm644 misc/zsh-completion  /usr/share/zsh/site-functions/_ninja</useri
       <varlistentry id="ninja">
         <term><command>ninja</command></term>
         <listitem>
-          <para>is the Ninja build system.</para>
+          <para>is the Ninja build system</para>
           <indexterm zone="ch-system-ninja ninja">
             <primary sortas="b-ninja">ninja</primary>
           </indexterm>

chapter08/openssl.xml

@@ -113,7 +113,7 @@ make MANSUFFIX=ssl install</userinput></screen>
         <listitem>
           <para>
             is a <application>Perl</application> script that scans all files in
-            a directory and adds symbolic links to their hash values.
+            a directory and adds symbolic links to their hash values
           </para>
           <indexterm zone="ch-system-openssl c_rehash">
             <primary sortas="b-c_rehash">c_rehash</primary>
@@ -128,7 +128,7 @@ make MANSUFFIX=ssl install</userinput></screen>
             is a command-line tool for using the various cryptography functions
             of <application>OpenSSL</application>'s crypto library from the
             shell. It can be used for various functions which are documented in
-            <command>man 1 openssl</command>.
+            <command>man 1 openssl</command>
           </para>
           <indexterm zone="ch-system-openssl openssl-prog">
             <primary sortas="b-openssl">openssl</primary>
@@ -146,7 +146,7 @@ make MANSUFFIX=ssl install</userinput></screen>
             TLS and S/MIME, and they have also been used to implement
             <application>OpenSSH</application>,
             <application>OpenPGP</application>, and other cryptographic
-            standards.
+            standards
           </para>
           <indexterm zone="ch-system-openssl libcrypto">
             <primary sortas="c-libcrypto">libcrypto.so</primary>
@@ -160,7 +160,7 @@ make MANSUFFIX=ssl install</userinput></screen>
           <para>
             implements the Transport Layer Security (TLS v1) protocol.
             It provides a rich API, documentation
-            on which can be found by running <command>man 3 ssl</command>.
+            on which can be found by running <command>man 3 ssl</command>
           </para>
           <indexterm zone="ch-system-openssl libssl">
             <primary sortas="c-libssl">libssl.so</primary>

chapter08/python.xml

@@ -158,7 +158,7 @@ tar --strip-components=1  \
             is a <application>Python</application> program that reads
             <application>Python 2.x</application> source code and applies a
             series of fixes to transform it into 
-            valid <application>Python 3.x</application> code.
+            valid <application>Python 3.x</application> code
           </para>
           <indexterm zone="ch-system-Python">
             <primary sortas="b-2to3">2to3</primary>
@@ -173,7 +173,7 @@ tar --strip-components=1  \
             is a wrapper script that opens a <application>Python</application>
             aware GUI editor. For this script to run, you must have installed
             <application>Tk</application> before Python so that the Tkinter
-            Python module is built.
+            Python module is built
           </para>
           <indexterm zone="ch-system-Python">
             <primary sortas="b-idle3">idle3</primary>
@@ -186,7 +186,7 @@ tar --strip-components=1  \
         <listitem>
           <para>
             The package installer for Python. You can use pip to install
-            packages from Python Package Index and other indexes.
+            packages from Python Package Index and other indexes
           </para>
           <indexterm zone="ch-system-Python">
             <primary sortas="b-pip3">pip3</primary>
@@ -198,7 +198,7 @@ tar --strip-components=1  \
         <term><command>pydoc3</command></term>
         <listitem>
           <para>
-            is the <application>Python</application> documentation tool.
+            is the <application>Python</application> documentation tool
           </para>
           <indexterm zone="ch-system-Python">
             <primary sortas="b-pydoc3">pydoc3</primary>
@@ -211,7 +211,7 @@ tar --strip-components=1  \
         <listitem>
           <para>
             is an interpreted, interactive, object-oriented programming
-            language.
+            language
           </para>
           <indexterm zone="ch-system-Python">
             <primary sortas="b-python3">python3</primary>

chapter08/readline.xml

@@ -141,7 +141,7 @@ ln -sfv ../../lib/$(readlink /usr/lib/libhistory.so ) /usr/lib/libhistory.so</us
         <term><filename class="libraryfile">libreadline</filename></term>
         <listitem>
           <para>Provides a set of commands for manipulating text entered in an
-          interactive session of a program.</para>
+          interactive session of a program</para>
           <indexterm zone="ch-system-readline libreadline">
             <primary sortas="c-libreadline">libreadline</primary>
           </indexterm>

chapter08/systemd.xml

@@ -348,7 +348,7 @@ meson --prefix=/usr                 \
           <para>Is the first process to be started when the kernel has initialized
           the hardware which takes over the boot process and starts all 
           processes according to its configuration files. In this case, it starts
-          systemd.</para>
+          systemd</para>
           <indexterm zone="ch-system-systemd init">
             <primary sortas="b-init">init</primary>
           </indexterm>
@@ -369,7 +369,7 @@ meson --prefix=/usr                 \
         <term><command>kernel-install</command></term>
         <listitem>
           <para>Is used to add and remove kernel and initramfs images to and
-          from /boot. In LFS, this is done manually.</para>
+          from /boot. In LFS, this is done manually</para>
           <indexterm zone="ch-system-systemd kernel-install">
             <primary sortas="b-kernel-install">kernel-install</primary>
           </indexterm>
@@ -469,7 +469,7 @@ meson --prefix=/usr                 \
         <listitem>
           <para>Sends control commands to the network name resolution
           manager, or resolves domain names, IPv4 and IPv6 addresses,
-          DNS records, and services.</para>
+          DNS records, and services</para>
           <indexterm zone="ch-system-systemd resolvectl">
             <primary sortas="b-resolvectl">resolvectl</primary>
           </indexterm>
@@ -535,7 +535,7 @@ meson --prefix=/usr                 \
         <term><command>systemd-cat</command></term>
         <listitem>
           <para>Is used to connect the STDOUT and STDERR outputs of a process
-          with the systemd journal.
+          with the systemd journal
           </para>
           <indexterm zone="ch-system-systemd systemd-cat">
             <primary sortas="b-systemd-cat">systemd-cat</primary>
@@ -581,7 +581,7 @@ meson --prefix=/usr                 \
         <term><command>systemd-detect-virt</command></term>
         <listitem>
           <para>Detects whether the system is being run in a virtual
-          environment, and adjusts udev accordingly.</para>
+          environment, and adjusts udev accordingly</para>
           <indexterm zone="ch-system-systemd systemd-detect-virt">
             <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
           </indexterm>
@@ -591,7 +591,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-dissect">
         <term><command>systemd-dissect</command></term>
         <listitem>
-          <para>Is used to inspect OS disk images.</para>
+          <para>Is used to inspect OS disk images</para>
           <indexterm zone="ch-system-systemd systemd-dissect">
             <primary sortas="b-systemd-dissect">systemd-dissect</primary>
           </indexterm>
@@ -634,7 +634,7 @@ meson --prefix=/usr                 \
         <listitem>
           <para>Is used to execute a program with a shutdown, sleep or idle
           inhibitor lock taken, preventing an action such as a system shutdown
-          until the process is completed.</para>
+          until the process is completed</para>
           <indexterm zone="ch-system-systemd systemd-inhibit">
             <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
           </indexterm>
@@ -656,7 +656,7 @@ meson --prefix=/usr                 \
       <varlistentry id="systemd-mount">
         <term><command>systemd-mount</command></term>
         <listitem>
-          <para>Is used to temporarily mount or automount disks.</para>
+          <para>Is used to temporarily mount or automount disks</para>
           <indexterm zone="ch-system-systemd systemd-mount">
             <primary sortas="b-systemd-mount">systemd-mount</primary>
           </indexterm>
@@ -699,7 +699,7 @@ meson --prefix=/usr                 \
         <term><command>systemd-repart</command></term>
         <listitem>
           <para>Is used to grow and add partitions to a partition table when
-          systemd is used in an OS image (e.g. a container).</para>
+          systemd is used in an OS image (e.g. a container)</para>
           <indexterm zone="ch-system-systemd systemd-repart">
             <primary sortas="b-systemd-repart">systemd-repart</primary>
           </indexterm>
@@ -722,7 +722,7 @@ meson --prefix=/usr                 \
         <listitem>
           <para>Is used to create and start a transient .service or a .scope
           unit and run the specified command in it. This is useful for
-          validating systemd units.</para>
+          validating systemd units</para>
           <indexterm zone="ch-system-systemd systemd-run">
             <primary sortas="b-systemd-run">systemd-run</primary>
           </indexterm>
@@ -733,7 +733,7 @@ meson --prefix=/usr                 \
         <term><command>systemd-socket-activate</command></term>
         <listitem>
           <para>Is used to listen on socket devices and launch a process upon
-          a successful connection to the socket.</para>
+          a successful connection to the socket</para>
           <indexterm zone="ch-system-systemd systemd-socket-activate">
             <primary sortas="b-systemd-socket-activate">systemd-socket-activate</primary>
           </indexterm>