Changeset de33b2a

Timestamp:

03/12/2020 09:24:44 AM (4 years ago)

Author:

Pierre Labastie <pieere@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

6ea9f5b3

Parents:

5ab87cfa

Message:

Format general/prog

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22835 af4574ff-66df-0310-9fd7-8a98e5e911e0

Location:

general/prog

Files:

• apache-ant.xml (modified) (12 diffs)
• clisp.xml (modified) (3 diffs)
• decorator.xml (modified) (1 diff)
• doxygen.xml (modified) (1 diff)
• expect.xml (modified) (30 diffs)
• java.xml (modified) (5 diffs)
• lua.xml (modified) (1 diff)
• lua52.xml (modified) (1 diff)
• mercurial.xml (modified) (8 diffs)
• nasm.xml (modified) (7 diffs)
• openjdk.xml (modified) (36 diffs)
• perl-deps/perl-file-find-rule.xml (modified) (1 diff)
• perl-deps/perl-libwww-perl.xml (modified) (6 diffs)
• perl-modules/perl-archive-zip.xml (modified) (1 diff)
• perl-modules/perl-lingua-translit.xml (modified) (1 diff)
• perl-modules/perl-log-log4perl.xml (modified) (1 diff)
• perl-modules/perl-parse-yapp.xml (modified) (1 diff)
• perl-modules/perl-text-bibtex.xml (modified) (4 diffs)
• prog.xml (modified) (2 diffs)
• python2.xml (modified) (1 diff)
• python3.xml (modified) (1 diff)
• rust.xml (modified) (2 diffs)
• slang.xml (modified) (7 diffs)
• svnserver.xml (modified) (11 diffs)
• vala.xml (modified) (2 diffs)
• yasm.xml (modified) (7 diffs)

general/prog/apache-ant.xml

@@ -30 +30 @@
     <title>Introduction to Apache Ant</title>
 
-    <para>The <application>Apache Ant</application> package is a
-    <application>Java</application>-based build tool. In theory, it is
-    like the <command>make</command> command, but without <command>make</command>'s
-    wrinkles. <application>Ant</application> is different. Instead of a model
-    that is extended with shell-based commands, <application>Ant</application>
-    is extended using <application>Java</application> classes. Instead of
-    writing shell commands, the configuration files are XML-based, calling out
-    a target tree that executes various tasks. Each task is run by an object
-    that implements a particular task interface.</para>
+    <para>
+      The <application>Apache Ant</application> package is a
+      <application>Java</application>-based build tool. In theory, it is
+      like the <command>make</command> command, but without
+      <command>make</command>'s wrinkles. <application>Ant</application> is
+      different. Instead of a model that is extended with shell-based commands,
+      <application>Ant</application> is extended using
+      <application>Java</application> classes. Instead of writing shell
+      commands, the configuration files are XML-based, calling out a target
+      tree that executes various tasks. Each task is run by an object that
+      implements a particular task interface.
+    </para>
 
     &lfs91_checked;
@@ -45 +48 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&apache-ant-download-http;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download (FTP): <ulink url="&apache-ant-download-ftp;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download MD5 sum: &apache-ant-md5sum;</para>
-      </listitem>
-      <listitem>
-        <para>Download size: &apache-ant-size;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated disk space required: &apache-ant-buildsize;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated build time: &apache-ant-time;</para>
+        <para>
+          Download (HTTP): <ulink url="&apache-ant-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&apache-ant-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &apache-ant-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &apache-ant-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &apache-ant-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &apache-ant-time;
+        </para>
       </listitem>
     </itemizedlist>
@@ -176 +191 @@
       <title>Config Files</title>
 
-      <para><filename>/etc/ant/ant.conf</filename>,
-      <filename>~/.ant/ant.conf</filename>, and
-      <filename>~/.antrc</filename></para>
+      <para>
+        <filename>/etc/ant/ant.conf</filename>,
+        <filename>~/.ant/ant.conf</filename>, and
+        <filename>~/.antrc</filename>
+      </para>
 
       <indexterm zone="apache-ant apache-ant-config">
@@ -197 +214 @@
       <title>Configuration Information</title>
 
-      <para>Some packages will require <command>ant</command> to be in the
-      search path and the <envar>ANT_HOME</envar> environment variable
-      defined. Satisfy these requirements by issuing, as the <systemitem
-      class="username">root</systemitem> user:</para>
+      <para>
+        Some packages will require <command>ant</command> to be in the
+        search path and the <envar>ANT_HOME</envar> environment variable
+        defined. Satisfy these requirements by issuing, as the <systemitem
+        class="username">root</systemitem> user:
+      </para>
 
 <screen role="root"><userinput>cat &gt; /etc/profile.d/ant.sh &lt;&lt; EOF
@@ -211 +230 @@
 EOF</userinput></screen>
 
-      <para>The above instrutions assume you have configured your system as
-      described in <xref linkend="postlfs-config-profile"/>.</para>
+      <para>
+        The above instructions assume you have configured your system as
+        described in <xref linkend="postlfs-config-profile"/>.
+      </para>
 
     </sect3>
@@ -245 +266 @@
         <term><command>ant</command></term>
         <listitem>
-          <para>is a <application>Java</application> based build tool used by
-          many packages instead of the conventional <command>make</command>
-          program.</para>
+          <para>
+            is a <application>Java</application> based build tool used by
+            many packages instead of the conventional <command>make</command>
+            program.
+          </para>
           <indexterm zone="apache-ant ant">
             <primary sortas="b-ant">ant</primary>
@@ -257 +280 @@
         <term><command>antRun</command></term>
         <listitem>
-          <para>is a support script used to start <command>ant</command>
-          build scripts in a given directory.</para>
+          <para>
+            is a support script used to start <command>ant</command>
+            build scripts in a given directory.
+          </para>
           <indexterm zone="apache-ant antRun">
             <primary sortas="b-antRun">antRun</primary>
@@ -268 +293 @@
         <term><command>antRun.pl</command></term>
         <listitem>
-          <para>is a <application>Perl</application> script that provides
-          similar functionality offered by the <command>antRun</command> script.</para>
+          <para>
+            is a <application>Perl</application> script that provides similar
+            functionality offered by the <command>antRun</command> script.
+          </para>
           <indexterm zone="apache-ant antRun.pl">
             <primary sortas="b-antRun.pl">antRun.pl</primary>
@@ -279 +306 @@
         <term><command>complete-ant-cmd.pl</command></term>
         <listitem>
-          <para>is a <application>Perl</application> script that allows
-          <application>Bash</application> to complete an <command>ant</command>
-          command-line.</para>
+          <para>
+            is a <application>Perl</application> script that allows
+            <application>Bash</application> to complete an
+            <command>ant</command> command-line.
+          </para>
           <indexterm zone="apache-ant complete-ant-cmd.pl">
             <primary sortas="b-complete-ant-cmd.pl">complete-ant-cmd.pl</primary>
@@ -291 +320 @@
         <term><command>runant.pl</command></term>
         <listitem>
-          <para>is a <application>Perl</application> wrapper script used to
-          invoke <command>ant</command>.</para>
+          <para>
+            is a <application>Perl</application> wrapper script used to
+            invoke <command>ant</command>.
+          </para>
           <indexterm zone="apache-ant runant.pl">
             <primary sortas="b-runant.pl">runant.pl</primary>
@@ -302 +333 @@
         <term><command>runant.py</command></term>
         <listitem>
-          <para>is a <application>Python</application> wrapper script used to
-          invoke <command>ant</command>.</para>
+          <para>
+            is a <application>Python</application> wrapper script used to
+            invoke <command>ant</command>.
+          </para>
           <indexterm zone="apache-ant runant.py">
             <primary sortas="b-runant.py">runant.py</primary>
@@ -313 +346 @@
         <term><filename class='libraryfile'>ant*.jar</filename></term>
         <listitem>
-          <para>files are the <application>Apache Ant</application>
-          <application>Java</application> class libraries.</para>
+          <para>
+            files are the <application>Apache Ant</application>
+            <application>Java</application> class libraries.
+          </para>
           <indexterm zone="apache-ant ant-star">
             <primary sortas="c-ant-star">ant-*.jar</primary>

general/prog/clisp.xml

@@ -74 +74 @@
     <itemizedlist spacing='compact'>
       <listitem>
-        <para>Optional patch: <ulink
+        <para>
+          Optional patch: <ulink
           url="&patch-root;/clisp-&clisp-version;-readline7_fixes-1.patch"/>
-          (required if building against libffcall)</para>
+          (required if building against libffcall)
+        </para>
       </listitem>
     </itemizedlist>
@@ -223 +225 @@
         <term><command>clisp</command></term>
         <listitem>
-          <para>is an ANSI Common Lisp compiler, interpreter, and debugger</para>
+          <para>
+            is an ANSI Common Lisp compiler, interpreter, and debugger
+          </para>
           <indexterm zone="clisp clisp-prog">
             <primary sortas="b-clisp">clisp</primary>
@@ -233 +237 @@
         <term><command>clisp-link</command></term>
         <listitem>
-          <para>is used to link an external module to clisp</para>
+          <para>
+            is used to link an external module to clisp
+          </para>
           <indexterm zone="clisp clisp-link">
             <primary sortas="b-clisp-link">clisp-link</primary>

general/prog/decorator.xml

@@ -74 +74 @@
       <title>Installation of decorator</title>
 
-      <para>Install decorator with the following commands:</para>
+      <para>
+        Install <application>decorator</application> with the following
+        commands:
+      </para>
 
 <screen><userinput>python3 setup.py build</userinput></screen>

general/prog/doxygen.xml

@@ -90 +90 @@
     <itemizedlist spacing='compact'>
       <listitem>
-        <para>Required patch: <ulink
-          url="&patch-root;/doxygen-&doxygen-version;-flex_2_6_0_fix-1.patch"/></para>
+        <para>
+          Required patch: <ulink
+          url="&patch-root;/doxygen-&doxygen-version;-flex_2_6_0_fix-1.patch"/>
+        </para>
       </listitem>
     </itemizedlist>-->

general/prog/expect.xml

@@ -30 +30 @@
     <title>Introduction to Expect</title>
 
-    <para>The <application>Expect</application> package was installed in the
-    LFS temporary tools directory for testing other packages.  These
-    procedures install it in a permanent location.  It contains tools for
-    automating interactive applications such as <command>telnet</command>,
-    <command>ftp</command>, <command>passwd</command>,
-    <command>fsck</command>, <command>rlogin</command>,
-    <command>tip</command>, etc. <application>Expect</application> is
-    also useful for testing these same applications as well as easing all sorts of
-    tasks that are prohibitively difficult with anything else.</para>
+    <para>
+      The <application>Expect</application> package was installed in the
+      LFS temporary tools directory for testing other packages.  These
+      procedures install it in a permanent location.  It contains tools for
+      automating interactive applications such as <command>telnet</command>,
+      <command>ftp</command>, <command>passwd</command>,
+      <command>fsck</command>, <command>rlogin</command>,
+      <command>tip</command>, etc. <application>Expect</application> is also
+      useful for testing these same applications as well as easing all sorts of
+      tasks that are prohibitively difficult with anything else.
+    </para>
 
     &lfs91_checked;
@@ -45 +47 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&expect-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&expect-download-http;"/>
+        </para>
       </listitem>
       <!-- <listitem>
-        <para>Download (FTP): <ulink url="&expect-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&expect-download-ftp;"/>
+        </para>
       </listitem> -->
       <listitem>
-        <para>Download MD5 sum: &expect-md5sum;</para>
+        <para>
+          Download MD5 sum: &expect-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &expect-size;</para>
+        <para>
+          Download size: &expect-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &expect-buildsize;</para>
+        <para>
+          Estimated disk space required: &expect-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &expect-time;</para>
+        <para>
+          Estimated build time: &expect-time;
+        </para>
       </listitem>
     </itemizedlist>
@@ -80 +94 @@
     <title>Installation of Expect</title>
 
-    <para>Install <application>Expect</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>Expect</application> by running the following
+      commands:
+    </para>
 
     <!-- Not sure if we need a static library as it does not build by default
@@ -93 +109 @@
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make test</command>.</para>
-
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      To test the results, issue: <command>make test</command>.
+    </para>
+
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install &amp;&amp;
@@ -105 +125 @@
     <title>Command Explanations</title>
 
-    <para><parameter>-with-tcl=/usr/lib</parameter>: This parameter is used to
-    tell the <command>configure</command> script where the
-    <command>tclConfig.sh</command> is located.</para>
-
-    <para><parameter>--enable-shared</parameter>: This option enables
-    building the shared library.</para>
+    <para>
+      <parameter>-with-tcl=/usr/lib</parameter>: This parameter is used to
+      tell the <command>configure</command> script where the
+      <command>tclConfig.sh</command> is located.
+    </para>
+
+    <para>
+      <parameter>--enable-shared</parameter>: This option enables
+      building the shared library.
+    </para>
 
     <!-- Not really sure if this is required any longer as the library is now
          installed directly in /usr/lib/expect5.45/. -->
-    <para><command>ln -sf ...</command>: This command creates a required link
-    to the shared library.</para>
+    <para>
+      <command>ln -sf ...</command>: This command creates a required link
+      to the shared library.
+    </para>
 
   </sect2>
@@ -125 +151 @@
       <title>Config Files</title>
 
-      <para><filename>$exp_library/expect.rc</filename> and
-      <filename>~/.expect.rc</filename></para>
+      <para>
+        <filename>$exp_library/expect.rc</filename> and
+        <filename>~/.expect.rc</filename>
+      </para>
 
       <indexterm zone="expect expect-config">
@@ -141 +169 @@
       <title>Configuration Information</title>
 
-      <para>Reference the <command>expect</command> man page for information about
-      utilizing the <filename>expect.rc</filename> configuration files. Additionally,
-      many of the tools contained in the <application>Expect</application> package
-      will use their own configuration files. Reference the respective man page, or
-      examine the script directly for configuration file information.</para>
+      <para>
+        Reference the <command>expect</command> man page for information about
+        utilizing the <filename>expect.rc</filename> configuration files.
+        Additionally, many of the tools contained in the
+        <application>Expect</application> package will use their own
+        configuration files. Reference the respective man page, or
+        examine the script directly for configuration file information.
+      </para>
 
     </sect3>
@@ -178 +209 @@
         <term><command>autoexpect</command></term>
         <listitem>
-          <para>generates an <application>Expect</application> script from
-          watching a session.</para>
+          <para>
+            generates an <application>Expect</application> script from
+            watching a session.
+          </para>
           <indexterm zone="expect autoexpect">
             <primary sortas="b-autoexpect">autoexpect</primary>
@@ -189 +222 @@
         <term><command>autopasswd</command></term>
         <listitem>
-          <para>is a wrapper to make <command>passwd</command>(1) be
-          non-interactive.</para>
+          <para>
+            is a wrapper to make <command>passwd</command>(1) be
+            non-interactive.
+          </para>
           <indexterm zone="expect autopasswd">
             <primary sortas="b-autopasswd">autopasswd</primary>
@@ -200 +235 @@
         <term><command>cryptdir</command></term>
         <listitem>
-          <para>encrypts all files in a directory.</para>
+          <para>
+            encrypts all files in a directory.
+          </para>
           <indexterm zone="expect cryptdir">
             <primary sortas="b-cryptdir">cryptdir</primary>
@@ -210 +247 @@
         <term><command>decryptdir</command></term>
         <listitem>
-          <para>decrypts all files in a directory.</para>
+          <para>
+            decrypts all files in a directory.
+          </para>
           <indexterm zone="expect decryptdir">
             <primary sortas="b-decryptdir">decryptdir</primary>
@@ -220 +259 @@
         <term><command>dislocate</command></term>
         <listitem>
-          <para>allows processes to be disconnected and reconnected to a
-          terminal.</para>
+          <para>
+            allows processes to be disconnected and reconnected to a
+            terminal.
+          </para>
           <indexterm zone="expect dislocate">
             <primary sortas="b-dislocate">dislocate</primary>
@@ -231 +272 @@
         <term><command>expect</command></term>
         <listitem>
-          <para>is a program that <quote>talks</quote> to other interactive
-          programs according to a script.</para>
+          <para>
+            is a program that <quote>talks</quote> to other interactive
+            programs according to a script.
+          </para>
           <indexterm zone="expect expect-prog">
             <primary sortas="b-expect">expect</primary>
@@ -242 +285 @@
         <term><command>ftp-rfc</command></term>
         <listitem>
-          <para>retrieves an RFC (or the index) from UUNET.</para>
+          <para>
+            retrieves an RFC (or the index) from UUNET.
+          </para>
           <indexterm zone="expect ftp-rfc">
             <primary sortas="b-ftp-rfc">ftp-rfc</primary>
@@ -252 +297 @@
         <term><command>kibitz</command></term>
         <listitem>
-          <para>allows two (or more) people to interact with one shell
-          (or any arbitrary program).</para>
+          <para>
+            allows two (or more) people to interact with one shell
+            (or any arbitrary program).
+          </para>
           <indexterm zone="expect kibitz">
             <primary sortas="b-kibitz">kibitz</primary>
@@ -263 +310 @@
         <term><command>lpunlock</command></term>
         <listitem>
-          <para>unhangs a printer which claims it is <quote>waiting for
-          lock</quote>.</para>
+          <para>
+            unhangs a printer which claims it is <quote>waiting for
+            lock</quote>.
+          </para>
           <indexterm zone="expect lpunlock">
             <primary sortas="b-lpunlock">lpunlock</primary>
@@ -274 +323 @@
         <term><command>mkpasswd</command></term>
         <listitem>
-          <para>generates passwords and can apply them automatically to
-          users.</para>
+          <para>
+            generates passwords and can apply them automatically to users.
+          </para>
           <indexterm zone="expect mkpasswd">
             <primary sortas="b-mkpasswd">mkpasswd</primary>
@@ -285 +335 @@
         <term><command>passmass</command></term>
         <listitem>
-          <para>changes a password on multiple machines.</para>
+          <para>
+            changes a password on multiple machines.
+          </para>
           <indexterm zone="expect passmass">
             <primary sortas="b-passmass">passmass</primary>
@@ -295 +347 @@
         <term><command>rftp</command></term>
         <listitem>
-          <para>is much like <command>ftp</command> except it uses
-          <option>~g</option> and <option>~p</option> instead of
-          <option>mget</option> and <option>mput</option>.</para>
+          <para>
+            is much like <command>ftp</command> except it uses
+            <option>~g</option> and <option>~p</option> instead of
+            <option>mget</option> and <option>mput</option>.
+          </para>
           <indexterm zone="expect rftp">
             <primary sortas="b-rftp">rftp</primary>
@@ -307 +361 @@
         <term><command>rlogin-cwd</command></term>
         <listitem>
-          <para>is <command>rlogin</command> except it uses the local current
-          directory as the current working directory on the remote machine.</para>
+          <para>
+            is <command>rlogin</command> except it uses the local current
+            directory as the current working directory on the remote machine.
+          </para>
           <indexterm zone="expect rlogin-cwd">
             <primary sortas="b-rlogin-cwd">rlogin-cwd</primary>
@@ -318 +374 @@
         <term><command>timed-read</command></term>
         <listitem>
-          <para> reads a complete line from stdin and aborts after a given
-          number of seconds.</para>
+          <para>
+            reads a complete line from stdin and aborts after a given
+            number of seconds.
+          </para>
           <indexterm zone="expect timed-read">
             <primary sortas="b-timed-read">timed-read</primary>
@@ -329 +387 @@
         <term><command>timed-run</command></term>
         <listitem>
-          <para>runs a program for a given amount of time.</para>
+          <para>
+            runs a program for a given amount of time.
+          </para>
           <indexterm zone="expect timed-run">
             <primary sortas="b-timed-run">timed-run</primary>
@@ -339 +399 @@
         <term><command>unbuffer</command></term>
         <listitem>
-          <para>disables the output buffering that occurs when program output
-          is redirected.</para>
+          <para>
+            disables the output buffering that occurs when program output
+            is redirected.
+          </para>
           <indexterm zone="expect unbuffer">
             <primary sortas="b-unbuffer">unbuffer</primary>
@@ -350 +412 @@
         <term><command>weather</command></term>
         <listitem>
-          <para>retrieves a weather report (courtesy University of Michigan)
-          for a given city or geographical area.</para>
+          <para>
+            retrieves a weather report (courtesy University of Michigan)
+            for a given city or geographical area.
+          </para>
           <indexterm zone="expect weather">
             <primary sortas="b-weather">weather</primary>
@@ -361 +425 @@
         <term><command>multixterm</command></term>
         <listitem>
-          <para>creates multiple <command>xterm</command>s that can be driven
-          together or separately.</para>
+          <para>
+            creates multiple <command>xterm</command>s that can be driven
+            together or separately.
+          </para>
           <indexterm zone="expect multixterm">
             <primary sortas="b-multixterm">multixterm</primary>
@@ -372 +438 @@
         <term><command>tknewsbiff</command></term>
         <listitem>
-          <para>pops up a window when there is unread news in your favorite
-          newsgroups and removes the window after you've read the news.</para>
+          <para>
+            pops up a window when there is unread news in your favorite
+            newsgroups and removes the window after you've read the news.
+          </para>
           <indexterm zone="expect tknewsbiff">
             <primary sortas="b-tknewsbiff">tknewsbiff</primary>
@@ -383 +451 @@
         <term><command>tkpasswd</command></term>
         <listitem>
-          <para>is a script to change passwords using
-          <command>expect</command> and <application>Tk</application>.</para>
+          <para>
+            is a script to change passwords using
+            <command>expect</command> and <application>Tk</application>.
+          </para>
           <indexterm zone="expect tkpasswd">
             <primary sortas="b-tkpasswd">tkpasswd</primary>
@@ -394 +464 @@
         <term><command>xkibitz</command></term>
         <listitem>
-          <para>allows users in separate <command>xterm</command>s to share
-          one shell (or any program that runs in an <command>xterm</command>).</para>
+          <para>
+            allows users in separate <command>xterm</command>s to share one
+            shell (or any program that runs in an <command>xterm</command>).
+          </para>
           <indexterm zone="expect xkibitz">
             <primary sortas="b-xkibitz">xkibitz</primary>
@@ -405 +477 @@
         <term><command>xpstat</command></term>
         <listitem>
-          <para>is a script that acts as a front-end for <command>xpilot</command>.</para>
+          <para>
+            is a script that acts as a front-end for <command>xpilot</command>.
+          </para>
           <indexterm zone="expect xpstat">
             <primary sortas="b-xpstat">xpstat</primary>
@@ -415 +489 @@
         <term><filename class='libraryfile'>libexpect&expect-version;.so</filename></term>
         <listitem>
-          <para> contains functions that allow <application>Expect</application> to be
-          used as a <application>Tcl</application> extension or to be used directly from
-          C or C++ (without <application>Tcl</application>).</para>
+          <para>
+            contains functions that allow <application>Expect</application> to
+            be used as a <application>Tcl</application> extension or to be
+            used directly from C or C++ (without
+            <application>Tcl</application>).
+          </para>
           <indexterm zone="expect libexpect">
             <primary sortas="c-libexpect&expect-version;">libexpect&expect-version;.so</primary>

general/prog/java.xml

@@ -41 +41 @@
   <sect2>
     <title>About Java</title>
-    <para>Java is different from most of the packages in LFS and BLFS. It
-    is a programming language that works with files of byte codes to obtain
-    instructions and executes then in a Java Virtual Machine (JVM). An
-    introductory java program looks like:</para>
+    <para>
+      Java is different from most of the packages in LFS and BLFS. It
+      is a programming language that works with files of byte codes to obtain
+      instructions and executes then in a Java Virtual Machine (JVM). An
+      introductory java program looks like:
+    </para>
 
 <screen><literal>public class HelloWorld
@@ -54 +56 @@
 }</literal></screen>
 
-    <para>This program is saved as <filename>HelloWorld.java</filename>. The
-    file name, <emphasis>HelloWorld</emphasis>, must match the class name. It
-    is then converted into byte code with
-    <command>javac HelloWorld.java</command>. The output file is
-    <filename>HelloWorld.class</filename>.  The program is executed with
-    <command>java HelloWorld</command>.  This creates a JVM and runs the
-    code.  The 'class' extension must not be specified.</para>
+    <para>
+      This program is saved as <filename>HelloWorld.java</filename>. The
+      file name, <emphasis>HelloWorld</emphasis>, must match the class name.
+      It is then converted into byte code with
+      <command>javac HelloWorld.java</command>. The output file is
+      <filename>HelloWorld.class</filename>.  The program is executed with
+      <command>java HelloWorld</command>.  This creates a JVM and runs the
+      code.  The 'class' extension must not be specified.
+    </para>
 
-    <para>Several class files can be combined into one file with the
-    <command>jar</command> command. This is similar to the standard
-    <command>tar</command> command. For instance, the command
-    <command>jar cf myjar.jar *.class</command> will combine all class files
-    in a directory into one jar file. These act as library files.</para>
+    <para>
+      Several class files can be combined into one file with the
+      <command>jar</command> command. This is similar to the standard
+      <command>tar</command> command. For instance, the command
+      <command>jar cf myjar.jar *.class</command> will combine all class files
+      in a directory into one jar file. These act as library files.
+    </para>
 
-    <para>The JVM can search for and use classes in jar files automatically.
-    It uses the <envar>CLASSPATH</envar> environment variable to search for
-    jar files. This is a standard list of colon-separated directory names
-    similar to the <envar>PATH</envar> environment variable.</para>
+    <para>
+      The JVM can search for and use classes in jar files automatically.
+      It uses the <envar>CLASSPATH</envar> environment variable to search for
+      jar files. This is a standard list of colon-separated directory names
+      similar to the <envar>PATH</envar> environment variable.
+    </para>
 
   </sect2>
@@ -78 +86 @@
     <title>Binary JDK Information</title>
 
-    <para>Creating a JVM from source requires a set of circular dependencies.
-    The first thing that's needed is a set of programs called a Java Development
-    Kit (JDK).  This set of programs includes <command>java</command>,
-    <command>javac</command>, <command>jar</command>, and several others. It
-    also includes several base <emphasis>jar</emphasis> files.</para>
+    <para>
+      Creating a JVM from source requires a set of circular dependencies.
+      The first thing that's needed is a set of programs called a Java
+      Development Kit (JDK).  This set of programs includes
+      <command>java</command>, <command>javac</command>,
+      <command>jar</command>, and several others. It also includes several
+      base <emphasis>jar</emphasis> files.
+    </para>
 
-    <para>To start, we set up a binary installation of the JDK created
-    by the BLFS editors.  It is installed in the <filename>/opt</filename>
-    directory to allow for multiple installations, including a source based
-    version.</para>
+    <para>
+      To start, we set up a binary installation of the JDK created
+      by the BLFS editors.  It is installed in the <filename>/opt</filename>
+      directory to allow for multiple installations, including a source based
+      version.
+    </para>
 
     &lfs91_checked;
@@ -94 +107 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Binary download (x86):
-        <ulink url="&openjdk-download-binary-x86;"/></para>
+        <para>
+          Binary download (x86): <ulink url="&openjdk-download-binary-x86;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &openjdk-bin-md5sum-x86;</para>
+        <para>
+          Download MD5 sum: &openjdk-bin-md5sum-x86;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size (binary): &openjdk-bin-size-x86;</para>
+        <para>
+          Download size (binary): &openjdk-bin-size-x86;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &openjdk-bin-buildsize-x86;</para>
+        <para>
+          Estimated disk space required: &openjdk-bin-buildsize-x86;
+        </para>
       </listitem>
     </itemizedlist>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Binary download (x86_64):
-        <ulink url="&openjdk-download-binary-x64;"/></para>
+        <para>
+          Binary download (x86_64): <ulink url="&openjdk-download-binary-x64;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &openjdk-bin-md5sum-x64;</para>
+        <para>
+          Download MD5 sum: &openjdk-bin-md5sum-x64;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size (binary): &openjdk-bin-size-x64;</para>
+        <para>
+          Download size (binary): &openjdk-bin-size-x64;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &openjdk-bin-buildsize-x64;</para>
+        <para>
+          Estimated disk space required: &openjdk-bin-buildsize-x64;
+        </para>
       </listitem>
     </itemizedlist>
@@ -135 +162 @@
   <sect2 role="installation">
     <title>Installation of the Java BinaryJDK </title>
-    <para>Begin by extracting the appropriate binary tarball for your
-    architecture and changing to the extracted directory. Install the binary
-    <application>OpenJDK</application> with the following commands as the
-    <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Begin by extracting the appropriate binary tarball for your
+      architecture and changing to the extracted directory. Install the binary
+      <application>OpenJDK</application> with the following commands as the
+      <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>install -vdm755 /opt/OpenJDK-&openjdk-version;+&openjdk-build;-bin &amp;&amp;

general/prog/lua.xml

@@ -122 +122 @@
     <title>Installation of Lua</title>
 
-    <para>Some packages check for the <application>pkg-config</application> file
-    for <application>Lua</application>, which is created with:</para>
+    <para>
+      Some packages check for the <application>pkg-config</application> file
+      for <application>Lua</application>, which is created with:
+    </para>
 
 <screen><userinput>cat &gt; lua.pc &lt;&lt; "EOF"

general/prog/lua52.xml

@@ -100 +100 @@
     <title>Installation of Lua 5.2</title>
 
-    <para>Some packages check for the <application>pkg-config</application> file
-    for <application>Lua</application>, which is created with:</para>
+    <para>
+      Some packages check for the <application>pkg-config</application> file
+      for <application>Lua</application>, which is created with:
+    </para>
 
 <screen><userinput>cat &gt; lua.pc &lt;&lt; "EOF"

general/prog/mercurial.xml

@@ -30 +30 @@
     <title>Introduction to Mercurial</title>
 
-    <para><application>Mercurial</application> is a distributed source control
-    management tool similar to <application>Git</application> and
-    <application>Bazaar</application>. <application>Mercurial</application> is
-    written in <application>Python</application> and is used by projects such as
-    Mozilla and Vim.</para>
+    <para>
+      <application>Mercurial</application> is a distributed source control
+      management tool similar to <application>Git</application> and
+      <application>Bazaar</application>. <application>Mercurial</application>
+      is written in <application>Python</application> and is used by projects
+      such as Mozilla and Vim.
+    </para>
 
     &lfs91_checked;
@@ -41 +43 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&mercurial-download-http;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download (FTP): <ulink url="&mercurial-download-ftp;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download MD5 sum: &mercurial-md5sum;</para>
-      </listitem>
-      <listitem>
-        <para>Download size: &mercurial-size;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated disk space required: &mercurial-buildsize;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated build time: &mercurial-time;</para>
+        <para>
+          Download (HTTP): <ulink url="&mercurial-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&mercurial-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &mercurial-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &mercurial-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &mercurial-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &mercurial-time;
+        </para>
       </listitem>
     </itemizedlist>
@@ -93 +107 @@
     <!-- seems to have a development rust port -->
 
-    <para>Build <application>Mercurial</application> by issuing the following
-    command:</para>
+    <para>
+      Build <application>Mercurial</application> by issuing the following
+      command:
+    </para>
 
 <screen><userinput>make build</userinput></screen>
 
-    <para>To build the documentation (requires <xref linkend="docutils"/>), 
-    issue:</para>
+    <para>
+      To build the documentation (requires <xref linkend="docutils"/>), issue:
+    </para>
 
 <screen remap="doc"><userinput>2to3 -w doc/hgmanpage.py &amp;&amp;
 PYTHON=python3 make doc</userinput></screen>
 
-<!-- All tests pass (or are skipped) at version 3.8.2
-    <para>Running the test suite is optional. Tests which fail may be disabled,
-    adding each one to <filename>tests/blacklists/failed-tests</filename>. In
-    order to execute the test suite using the temporary directory <filename
-    class="directory">tests/tmp</filename> and skipping the failing tests,
-    issue:</para>
-
-    Version 5.2.1 had one failure test-bundle2-exchange.t
-
-
-<screen remap="test"><userinput>cat &gt; tests/blacklists/failed-tests &lt;&lt; "EOF"
-<literal># Test Failures
-  test-gpg.t</literal>
-EOF
--->
     <para>
       To run the test suite, issue:
@@ -127 +129 @@
      of tests/blacklists, but do not include the makefile. -->
 
-    <para>where <replaceable>&lt;N&gt;</replaceable> is an integer between one
-    and the number of ( processor X threads ), inclusive.  In order to
-    investigate any apparently failing tests, you may use the
-    <command>run-tests.py</command> script. To see the almost forty switches,
-    some of them very useful, issue <command>tests/run-tests.py
-    --help</command>.  Running the following commands, you will execute only
-    the tests that failed before:</para>
+    <para>
+      where <replaceable>&lt;N&gt;</replaceable> is an integer between one
+      and the number of ( processor X threads ), inclusive.  In order to
+      investigate any apparently failing tests, you may use the
+      <command>run-tests.py</command> script. To see the almost forty switches,
+      some of them very useful, issue <command>tests/run-tests.py
+      --help</command>.  Running the following commands, you will execute only
+      the tests that failed before:
+    </para>
 
 <screen remap="test"><userinput>pushd tests  &amp;&amp;
@@ -140 +144 @@
 popd</userinput></screen>
 
-    <para>Normally, the previous failures will be confirmed. However, if
-    you add the switch
-    "--debug" before "--tmpdir", and run again, some failures are gone, which
-    seems to be a problem with the test suite. If this happens, normally, from
-    now on, there will be no more such failures whether you use the debug switch
-    or not. Three tests, test-alias.t, test-install.t, and
-    test-bundle2-exchange.t (intermittently), are known to fail.</para>
-
-    <para>An interesting switch is "--time", which will generate at the end of
-    the test suite execution, a table with all executed tests and respective
-    start, end, user, system and real times. Note that the switches may be
-    used with <command>make check</command> by including them in the
-    <envar>TESTFLAGS</envar> environment variable.</para>
-
-    <para>Install <application>Mercurial</application> by running the following
-    command (as <systemitem class="username">root</systemitem>):</para>
+    <para>
+      Normally, the previous failures will be confirmed. However, if
+      you add the switch <option>--debug</option> before
+      <option>--tmpdir</option>, and run again, some failures are gone, which
+      seems to be a problem with the test suite. If this happens, normally,
+      from now on, there will be no more such failures whether you use the
+      debug switch or not. Three tests, test-alias.t, test-install.t, and
+      test-bundle2-exchange.t (intermittently), are known to fail.
+    </para>
+
+    <para>
+      An interesting switch is <option>--time</option>, which will generate at
+      the end of the test suite execution, a table with all executed tests and
+      respective start, end, user, system and real times. Note that the
+      switches may be used with <command>make check</command> by including
+      them in the <envar>TESTFLAGS</envar> environment variable.
+    </para>
+
+    <para>
+      Install <application>Mercurial</application> by running the following
+      command (as <systemitem class="username">root</systemitem>):
+    </para>
 
 <screen role="root"><userinput>make PREFIX=/usr install-bin</userinput></screen>
 
-    <para>If you built the documentation, install it by running the following
-    command (as <systemitem class="username">root</systemitem>):</para>
+    <para>
+      If you built the documentation, install it by running the following
+      command (as <systemitem class="username">root</systemitem>):
+    </para>
 
 <screen role="root"
         remap="doc"><userinput>make PREFIX=/usr install-doc</userinput></screen>
 
-    <para>After installation, two very quick and simple tests should run 
-    correctly. The first one needs some configuration:</para>
+    <para>
+      After installation, two very quick and simple tests should run 
+      correctly. The first one needs some configuration:
+    </para>
 
 <screen><userinput>cat &gt;&gt; ~/.hgrc &lt;&lt; "EOF"
@@ -173 +187 @@
 EOF</userinput></screen>
 
-    <para>where you must replace &lt;user_name&gt; and &lt;your@mail&gt; (mail
-    is optional and can be omitted). With the user identity defined, run
-    <command>hg debuginstall</command> and several lines will be displayed,
-    the last one reading "no problems detected". Another quick and simple test
-    is just <command>hg</command>, which should output basic commands that can
-    be used with <command>hg</command>.</para>
+    <para>
+      where you must replace &lt;user_name&gt; and &lt;your@mail&gt; (mail
+      is optional and can be omitted). With the user identity defined, run
+      <command>hg debuginstall</command> and several lines will be displayed,
+      the last one reading "no problems detected". Another quick and simple
+      test is just <command>hg</command>, which should output basic commands
+      that can be used with <command>hg</command>.
+    </para>
 
   </sect2>
@@ -211 +227 @@
       </indexterm>
 
-      <para>The great majority of extensions are disabled by default. Run
-      <command>hg help extensions</command> if you need to enable any, e.g.
-      when investigating test failures. You will obtain the lists of enabled and
-      disabled extensions, and more information, such as how to enable or
-      disable them using configuration files.</para>
-
-      <para>If you have installed <xref linkend="make-ca"/> and want
-      <application>Mercurial</application> to use them, as the <systemitem
-      class="username">root</systemitem> user, issue:</para>
+      <para>
+        The great majority of extensions are disabled by default. Run
+        <command>hg help extensions</command> if you need to enable any, e.g.
+        when investigating test failures. You will obtain the lists of enabled
+        and disabled extensions, and more information, such as how to enable
+        or disable them using configuration files.
+      </para>
+
+      <para>
+        If you have installed <xref linkend="make-ca"/> and want
+        <application>Mercurial</application> to use them, as the <systemitem
+        class="username">root</systemitem> user, issue:
+      </para>
 
 <screen role="root"><userinput>install -v -d -m755 /etc/mercurial &amp;&amp;
@@ -262 +282 @@
         <term><command>hg</command></term>
         <listitem>
-          <para>is the mercurial version control system.</para>
+          <para>
+            is the mercurial version control system.
+          </para>
           <indexterm zone="mercurial hg">
             <primary sortas="b-hg">hg</primary>

general/prog/nasm.xml

@@ -30 +30 @@
     <title>Introduction to NASM</title>
 
-    <para><application>NASM</application> (Netwide Assembler)
-    is an 80x86 assembler designed for portability and modularity. It includes a
-    disassembler as well.</para>
+    <para>
+      <application>NASM</application> (Netwide Assembler) is an 80x86
+      assembler designed for portability and modularity. It includes a
+      disassembler as well.
+    </para>
 
     &lfs91_checked;
@@ -39 +41 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&nasm-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&nasm-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&nasm-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&nasm-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &nasm-md5sum;</para>
+        <para>
+          Download MD5 sum: &nasm-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &nasm-size;</para>
+        <para>
+          Download size: &nasm-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &nasm-buildsize;</para>
+        <para>
+          Estimated disk space required: &nasm-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &nasm-time;</para>
+        <para>
+          Estimated build time: &nasm-time;
+        </para>
       </listitem>
     </itemizedlist>
@@ -61 +75 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Optional documentation: <ulink
-        url="http://www.nasm.us/pub/nasm/releasebuilds/&nasm-version;/nasm-&nasm-version;-xdoc.tar.xz"/></para>
+        <para>
+          Optional documentation: <ulink
+          url="http://www.nasm.us/pub/nasm/releasebuilds/&nasm-version;/nasm-&nasm-version;-xdoc.tar.xz"/>
+        </para>
       </listitem>
     </itemizedlist>
@@ -82 +98 @@
     <title>Installation of NASM</title>
 
-    <para>If you downloaded the optional documentation, put it into the
-    source tree:</para>
+    <para>
+      If you downloaded the optional documentation, put it into the
+      source tree:
+    </para>
 
 <screen><userinput>tar -xf ../nasm-&nasm-version;-xdoc.tar.xz --strip-components=1</userinput></screen>
 
-    <para>Install <application>NASM</application> by running
-    the following commands:</para>
+    <para>
+      Install <application>NASM</application> by running
+      the following commands:
+    </para>
 
 <screen><userinput>./configure --prefix=/usr &amp;&amp;
 make</userinput></screen>
 
-    <para>This package does not come with a test suite.</para>
+    <para>
+      This package does not come with a test suite.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <!-- dev note: make INSTALLROOT=<DESTDIR> install -->
@@ -101 +125 @@
 <screen role="root"><userinput>make install</userinput></screen>
 
-    <para>If you downloaded the optional documentation, install it with the
-    following instructions as the <systemitem
-    class="username">root</systemitem> user:</para>
+    <para>
+      If you downloaded the optional documentation, install it with the
+      following instructions as the <systemitem
+      class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>install -m755 -d         /usr/share/doc/nasm-&nasm-version;/html  &amp;&amp;
@@ -134 +160 @@
         <term><command>nasm</command></term>
         <listitem>
-          <para>is a portable 80x86 assembler.</para>
+          <para>
+            is a portable 80x86 assembler.
+          </para>
           <indexterm zone="nasm nasm-prog">
             <primary sortas="b-nasm">nasm</primary>
@@ -144 +172 @@
         <term><command>ndisasm</command></term>
         <listitem>
-          <para>is an 80x86 binary file disassembler.</para>
+          <para>
+            is an 80x86 binary file disassembler.
+          </para>
           <indexterm zone="nasm ndisasm">
             <primary sortas="b-ndisasm">ndisasm</primary>

general/prog/openjdk.xml

@@ -121 +121 @@
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &ojdk-bdsize;</para>
+        <para>
+          Estimated disk space required: &ojdk-bdsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &ojdk-time;</para>
+        <para>
+          Estimated build time: &ojdk-time;
+        </para>
       </listitem>
     </itemizedlist>
@@ -267 +271 @@
 unset JT_JAVA</userinput></screen>
 
-    <para>For more control over the test suite, review the documentation
-    available in <filename>jtreg/doc/jtreg/usage.txt</filename>. To review the
-    results, see the files
-    <filename>JTreport/test_{jdk,langtools}/text/stats.txt</filename> and
-    <filename>JTreport/test_{jdk,langtools}/text/summary.txt</filename>.
-    You should expect to see around 40 failures and a couple of errors.</para>
+    <para>
+      For more control over the test suite, review the documentation
+      available in <filename>jtreg/doc/jtreg/usage.txt</filename>. To review
+      the results, see the files
+      <filename>JTreport/test_{jdk,langtools}/text/stats.txt</filename> and
+      <filename>JTreport/test_{jdk,langtools}/text/summary.txt</filename>.
+      You should expect to see around 40 failures and a couple of errors.
+    </para>
     <!-- 11.0.2+9:
          for x86_64: 2 Errors, 28 Failures
@@ -280 +286 @@
          for i686: PENDING -->
 
-    <para>Install the package with the following commands as the
-    <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Install the package with the following commands as the
+      <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>install -vdm755 /opt/jdk-&openjdk-version;+&openjdk-build;             &amp;&amp;
@@ -510 +518 @@
       <?dbfo list-presentation="list"?>
       <?dbhtml list-presentation="table"?>
-<!--
-      <varlistentry id="appletviewer">
-        <term><command>appletviewer</command></term>
-        <listitem>
-          <para>allows to run applets outside of a web browser.</para>
-          <indexterm zone="openjdk appletviewer">
-            <primary sortas="b-appletviewer">appletviewer</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="idlj">
-        <term><command>idlj</command></term>
-        <listitem>
-          <para>generates Java bindings from a given IDL file.</para>
-          <indexterm zone="openjdk idlj">
-            <primary sortas="b-idlj">idlj</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
--->
+
       <varlistentry id="jaotc">
         <term><command>jaotc</command></term>
         <listitem>
-          <para>is an <quote>ahead-of-time</quote> java class compiler.</para>
+          <para>
+            is an <quote>ahead-of-time</quote> java class compiler.
+          </para>
           <indexterm zone="openjdk jaotc">
             <primary sortas="b-jaotc">jaotc</primary>
@@ -544 +534 @@
         <term><command>jar</command></term>
         <listitem>
-          <para>combines multiple files into a single jar archive.</para>
+          <para>
+            combines multiple files into a single jar archive.
+          </para>
           <indexterm zone="openjdk jar">
             <primary sortas="b-jar">jar</primary>
@@ -554 +546 @@
         <term><command>jarsigner</command></term>
         <listitem>
-          <para>signs jar files and verifies the signatures and integrity
-          of a signed jar file.</para>
+          <para>
+            signs jar files and verifies the signatures and integrity
+            of a signed jar file.
+          </para>
           <indexterm zone="openjdk jarsigner">
             <primary sortas="b-jarsigner">jarsigner</primary>
@@ -565 +559 @@
         <term><command>java</command></term>
         <listitem>
-          <para>launches a Java application by starting a Java runtime
-          environment, loading a specified class and invoking its main
-          method.</para>
+          <para>
+            launches a Java application by starting a Java runtime
+            environment, loading a specified class and invoking its main
+            method.
+          </para>
           <indexterm zone="openjdk java-prog">
             <primary sortas="b-java-prog">java</primary>
@@ -577 +573 @@
         <term><command>javac</command></term>
         <listitem>
-          <para>reads class and interface definitions, written in the
-          Java programming language, and compiles them into bytecode
-          class files.</para>
+          <para>
+            reads class and interface definitions, written in the
+            Java programming language, and compiles them into bytecode
+            class files.
+          </para>
           <indexterm zone="openjdk javac">
             <primary sortas="b-javac">javac</primary>
@@ -589 +587 @@
         <term><command>javadoc</command></term>
         <listitem>
-          <para>parses the declarations and documentation comments in a
-          set of Java source files and produces a corresponding set of
-          HTML pages describing the classes, interfaces, constructors,
-          methods, and fields.</para>
+          <para>
+            parses the declarations and documentation comments in a
+            set of Java source files and produces a corresponding set of
+            HTML pages describing the classes, interfaces, constructors,
+            methods, and fields.
+          </para>
           <indexterm zone="openjdk javadoc">
             <primary sortas="b-javadoc">javadoc</primary>
@@ -602 +602 @@
         <term><command>javap</command></term>
         <listitem>
-          <para>disassembles a Java class file.</para>
+          <para>
+            disassembles a Java class file.
+          </para>
           <indexterm zone="openjdk javap">
             <primary sortas="b-javap">javap</primary>
@@ -612 +614 @@
         <term><command>jcmd</command></term>
         <listitem>
-          <para>is a utility to send diagnostic command requests to a running
-          Java Virtual Machine.</para>
+          <para>
+            is a utility to send diagnostic command requests to a running
+            Java Virtual Machine.
+          </para>
           <indexterm zone="openjdk jcmd">
             <primary sortas="b-jcmd">jcmd</primary>
@@ -623 +627 @@
         <term><command>jconsole</command></term>
         <listitem>
-          <para>is a graphical console tool to monitor and manage both
-          local and remote Java applications and virtual machines.</para>
+          <para>
+            is a graphical console tool to monitor and manage both
+            local and remote Java applications and virtual machines.
+          </para>
           <indexterm zone="openjdk jconsole">
             <primary sortas="b-jconsole">jconsole</primary>
@@ -634 +640 @@
         <term><command>jdb</command></term>
         <listitem>
-          <para>is a simple command-line debugger for Java classes.</para>
+          <para>
+            is a simple command-line debugger for Java classes.
+          </para>
           <indexterm zone="openjdk jdb">
             <primary sortas="b-jdb">jdb</primary>
@@ -644 +652 @@
         <term><command>jdeprscan</command></term>
         <listitem>
-          <para>scans class or jar files for uses of deprecated API
-          elements.</para>
+          <para>
+            scans class or jar files for uses of deprecated API elements.
+          </para>
           <indexterm zone="openjdk jdeprscan">
             <primary sortas="b-jdeprscan">jdeprscan</primary>
@@ -655 +664 @@
         <term><command>jdeps</command></term>
         <listitem>
-          <para>shows the package-level or class-level dependencies of
-          Java class files.</para>
+          <para>
+            shows the package-level or class-level dependencies of
+            Java class files.
+          </para>
           <indexterm zone="openjdk jdeps">
             <primary sortas="b-jdeps">jdeps</primary>
@@ -666 +677 @@
         <term><command>jhsdb</command></term>
         <listitem>
-          <para>is a tool to analyze the content of a core dump from a
-          crashed Java Virtual Machine (JVM).</para>
+          <para>
+            is a tool to analyze the content of a core dump from a
+            crashed Java Virtual Machine (JVM).
+          </para>
           <indexterm zone="openjdk jhsdb">
             <primary sortas="b-jhsdb">jhsdb</primary>
@@ -677 +690 @@
         <term><command>jimage</command></term>
         <listitem>
-          <para>is used to list, extract, verify, or get information about
-          modules in <emphasis>jimage</emphasis> format.</para>
+          <para>
+            is used to list, extract, verify, or get information about
+            modules in <emphasis>jimage</emphasis> format.
+          </para>
           <indexterm zone="openjdk jimage">
             <primary sortas="b-jimage">jimage</primary>
@@ -688 +703 @@
         <term><command>jinfo</command></term>
         <listitem>
-          <para>prints Java configuration information for a given Java
-          process, core file, or a remote debug server.</para>
+          <para>
+            prints Java configuration information for a given Java
+            process, core file, or a remote debug server.
+          </para>
           <indexterm zone="openjdk jinfo">
             <primary sortas="b-jinfo">jinfo</primary>
@@ -699 +716 @@
         <term><command>jjs</command></term>
         <listitem>
-          <para>is a command-line tool used to invoke the Nashorn engine. It
-          can be used to interpret one or several script files, or to run
-          an interactive shell.</para>
+          <para>
+            is a command-line tool used to invoke the Nashorn engine. It
+            can be used to interpret one or several script files, or to run
+            an interactive shell.
+          </para>
           <indexterm zone="openjdk jjs">
             <primary sortas="b-jjs">jjs</primary>
@@ -711 +730 @@
         <term><command>jlink</command></term>
         <listitem>
-          <para>is used to assemble and optimize a set of modules and their
-          dependencies into a custom runtime image.</para>
+          <para>
+            is used to assemble and optimize a set of modules and their
+            dependencies into a custom runtime image.
+          </para>
           <indexterm zone="openjdk jlink">
             <primary sortas="b-jlink">jlink</primary>
@@ -722 +743 @@
         <term><command>jmap</command></term>
         <listitem>
-          <para>prints shared object memory maps or heap memory details
-          of a given process, core file, or a remote debug server.</para>
+          <para>
+            prints shared object memory maps or heap memory details
+            of a given process, core file, or a remote debug server.
+          </para>
           <indexterm zone="openjdk jmap">
             <primary sortas="b-jmap">jmap</primary>
@@ -733 +756 @@
         <term><command>jmod</command></term>
         <listitem>
-          <para>creates JMOD files and lists the content of existing JMOD
-          files.</para>
+          <para>
+            creates JMOD files and lists the content of existing JMOD files.
+          </para>
           <indexterm zone="openjdk jmod">
             <primary sortas="b-jmod">jmod</primary>
@@ -744 +768 @@
         <term><command>jps</command></term>
         <listitem>
-          <para>lists the instrumented JVMs on the target system.</para>
+          <para>
+            lists the instrumented JVMs on the target system.
+          </para>
           <indexterm zone="openjdk jps">
             <primary sortas="b-jps">jps</primary>
@@ -754 +780 @@
         <term><command>jrunscript</command></term>
         <listitem>
-          <para>is a command line script shell.</para>
+          <para>
+            is a command line script shell.
+          </para>
           <indexterm zone="openjdk jrunscript">
             <primary sortas="b-jrunscript">jrunscript</primary>
@@ -764 +792 @@
         <term><command>jshell</command></term>
         <listitem>
-          <para>is an interactive tool for learning the Java programming
-          language and prototyping Java code.</para>
+          <para>
+            is an interactive tool for learning the Java programming
+            language and prototyping Java code.
+          </para>
           <indexterm zone="openjdk jshell">
             <primary sortas="b-jshell">jshell</primary>
@@ -775 +805 @@
         <term><command>jstack</command></term>
         <listitem>
-          <para>prints Java stack traces of Java threads for a given
-          Java process, core file, or a remote debug server.</para>
+          <para>
+            prints Java stack traces of Java threads for a given
+            Java process, core file, or a remote debug server.
+          </para>
           <indexterm zone="openjdk jstack">
             <primary sortas="b-jstack">jstack</primary>
@@ -786 +818 @@
         <term><command>jstat</command></term>
         <listitem>
-          <para>displays performance statistics for an instrumented JVM.</para>
+          <para>
+            displays performance statistics for an instrumented JVM.
+          </para>
           <indexterm zone="openjdk jstat">
             <primary sortas="b-jstat">jstat</primary>
@@ -796 +830 @@
         <term><command>jstatd</command></term>
         <listitem>
-          <para>is an RMI server application that monitors for the creation
-          and termination of instrumented JVMs.</para>
+          <para>
+            is an RMI server application that monitors for the creation
+            and termination of instrumented JVMs.
+          </para>
           <indexterm zone="openjdk jstatd">
             <primary sortas="b-jstatd">jstatd</primary>
@@ -807 +843 @@
         <term><command>keytool</command></term>
         <listitem>
-          <para>is a key and certificate management utility.</para>
+          <para>
+            is a key and certificate management utility.
+          </para>
           <indexterm zone="openjdk keytool">
             <primary sortas="b-keytool">keytool</primary>
@@ -813 +851 @@
         </listitem>
       </varlistentry>
-<!--
-      <varlistentry id="orbd">
-        <term><command>orbd</command></term>
-        <listitem>
-          <para>is used to enable clients to transparently locate and invoke
-          persistent objects on servers in the CORBA environment.</para>
-          <indexterm zone="openjdk orbd">
-            <primary sortas="b-orbd">orbd</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
--->
+
       <varlistentry id="pack200">
         <term><command>pack200</command></term>
         <listitem>
-          <para>is a Java application that transforms a jar file into a
-          compressed pack200 file using the Java gzip compressor.</para>
+          <para>
+            is a Java application that transforms a jar file into a
+            compressed pack200 file using the Java gzip compressor.
+          </para>
           <indexterm zone="openjdk pack200">
             <primary sortas="b-pack200">pack200</primary>
@@ -839 +868 @@
         <term><command>rmic</command></term>
         <listitem>
-          <para>generates stub and skeleton class files for remote objects
-          from the names of compiled Java classes that contain remote
-          object implementations.</para>
+          <para>
+            generates stub and skeleton class files for remote objects
+            from the names of compiled Java classes that contain remote
+            object implementations.
+          </para>
           <indexterm zone="openjdk rmic">
             <primary sortas="b-rmic">rmic</primary>
@@ -851 +882 @@
         <term><command>rmid</command></term>
         <listitem>
-          <para>starts the activation system daemon.</para>
+          <para>
+            starts the activation system daemon.
+          </para>
           <indexterm zone="openjdk rmid">
             <primary sortas="b-rmid">rmid</primary>
@@ -861 +894 @@
         <term><command>rmiregistry</command></term>
         <listitem>
-          <para>creates and starts a remote object registry on the specified
-          port on the current host.</para>
+          <para>
+            creates and starts a remote object registry on the specified
+            port on the current host.
+          </para>
           <indexterm zone="openjdk rmiregistry">
             <primary sortas="b-rmiregistry">rmiregistry</primary>
@@ -868 +903 @@
         </listitem>
       </varlistentry>
-<!--
-      <varlistentry id="schemagen">
-        <term><command>schemagen</command></term>
-        <listitem>
-          <para>is a Java XML binding schema generator.</para>
-          <indexterm zone="openjdk schemagen">
-            <primary sortas="b-schemagen">schemagen</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
--->
+
       <varlistentry id="serialver">
         <term><command>serialver</command></term>
         <listitem>
-          <para>returns the serialVersionUID for one or more classes in a
-          form suitable for copying into an evolving class.</para>
+          <para>
+            returns the serialVersionUID for one or more classes in a
+            form suitable for copying into an evolving class.
+          </para>
           <indexterm zone="openjdk serialver">
             <primary sortas="b-serialver">serialver</primary>
@@ -889 +916 @@
         </listitem>
       </varlistentry>
-<!--
-      <varlistentry id="servertool">
-        <term><command>servertool</command></term>
-        <listitem>
-          <para>provides an ease-of-use interface for application programmers
-          to register, unregister, startup and shutdown a server.</para>
-          <indexterm zone="openjdk servertool">
-            <primary sortas="b-servertool">servertool</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="tnameserv">
-        <term><command>tnameserv</command></term>
-        <listitem>
-          <para>starts the Java IDL name server.</para>
-          <indexterm zone="openjdk tnameserv">
-            <primary sortas="b-tnameserv">tnameserv</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
--->
+
       <varlistentry id="unpack200">
         <term><command>unpack200</command></term>
         <listitem>
-          <para>is a native implementation that transforms a packed file
-          produced by <application>pack200</application> into a jar
-          file.</para>
+          <para>
+            is a native implementation that transforms a packed file
+            produced by <application>pack200</application> into a jar
+            file.
+          </para>
           <indexterm zone="openjdk unpack200">
             <primary sortas="b-unpack200">unpack200</primary>
@@ -922 +930 @@
         </listitem>
       </varlistentry>
-<!--
-      <varlistentry id="wsgen">
-        <term><command>wsgen</command></term>
-        <listitem>
-          <para>generates JAX-WS portable artifacts used in JAX-WS
-          web services.</para>
-          <indexterm zone="openjdk wsgen">
-            <primary sortas="b-wsgen">wsgen</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="wsimport">
-        <term><command>wsimport</command></term>
-        <listitem>
-          <para>generates JAX-WS portable artifacts.</para>
-          <indexterm zone="openjdk wsimport">
-            <primary sortas="b-wsimport">wsimport</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
-
-      <varlistentry id="xjc">
-        <term><command>xjc</command></term>
-        <listitem>
-          <para>is a Java XML binding compiler.</para>
-          <indexterm zone="openjdk xjc">
-            <primary sortas="b-xjc">xjc</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>
--->
+
     </variablelist>
 

general/prog/perl-deps/perl-file-find-rule.xml

@@ -82 +82 @@
           <term><command>findrule</command></term>
           <listitem>
-            <para>is a command line wrapper to File::Find::Rule.</para>
+            <para>
+              is a command line wrapper to File::Find::Rule.
+            </para>
             <indexterm zone="perl-file-find-rule findrule-prog">
               <primary sortas="b-findrule">findrule</primary>

general/prog/perl-deps/perl-libwww-perl.xml

@@ -32 +32 @@
       </para>
 
-      <!-- FOr CPAN, this may be pulled in with 'cpan -i Bundle::LWP'  -->
+      <!-- For CPAN, this may be pulled in with 'cpan -i Bundle::LWP'  -->
 
       &lfs91_checked;
@@ -84 +84 @@
 
       <para>
-       After installing this package, if you want HTTPS protocol support install
-       <xref linkend="perl-lwp-protocol-https"/>.
+        After installing this package, if you want HTTPS protocol support
+        install <xref linkend="perl-lwp-protocol-https"/>.
       </para>
 
@@ -111 +111 @@
           <term><command>lwp-download</command></term>
           <listitem>
-            <para>is a script to fetch a large file from the web.</para>
+            <para>
+              is a script to fetch a large file from the web.
+            </para>
             <!-- the -prog is for while (old) and new- perl module pages
              are both in the book, without it the link to the package is
@@ -125 +127 @@
           <term><command>lwp-dump</command></term>
           <listitem>
-            <para>is used to see what headers and content is returned
-            for a URL.</para>
+            <para>
+              is used to see what headers and content is returned for a URL.
+            </para>
             <indexterm zone="perl-libwww-perl lwp-dump-prog">
               <primary sortas="b-lwp-dump">lwp-dump</primary>
@@ -136 +139 @@
           <term><command>lwp-mirror</command></term>
           <listitem>
-            <para>is a simple mirror utility.</para>
+            <para>
+              is a simple mirror utility.
+            </para>
             <indexterm zone="perl-libwww-perl lwp-mirror-prog">
               <primary sortas="b-lwp-mirror">lwp-mirror</primary>
@@ -146 +151 @@
           <term><command>lwp-request</command></term>
           <listitem>
-            <para>is a simple command line user agent.</para>
+            <para>
+              is a simple command line user agent.
+            </para>
             <indexterm zone="perl-libwww-perl lwp-request-prog">
               <primary sortas="b-lwp-request">lwp-request</primary>

general/prog/perl-modules/perl-archive-zip.xml

@@ -85 +85 @@
           <term><command>crc32</command></term>
           <listitem>
-            <para>computes and prints to stdout the CRC-32 values of the given files.</para>
+            <para>
+              computes and prints to stdout the CRC-32 values of the given
+              files.
+            </para>
             <indexterm zone="perl-archive-zip crc32-prog">
               <primary sortas="b-crc32">crc32</primary>

general/prog/perl-modules/perl-lingua-translit.xml

@@ -74 +74 @@
           <term><command>translit</command></term>
           <listitem>
-            <para>transliterates text between writing systems using
-            various standards.</para>
+            <para>
+              transliterates text between writing systems using various
+              standards.
+            </para>
             <indexterm zone="perl-lingua-translit translit-prog">
               <primary sortas="b-translit">translit</primary>

general/prog/perl-modules/perl-log-log4perl.xml

@@ -74 +74 @@
           <term><command>l4p-templ</command></term>
           <listitem>
-            <para>prints out the text of a template Log4perl configuration for
-            starting a new Log4perl configuration file.</para>
+            <para>
+              prints out the text of a template Log4perl configuration for
+              starting a new Log4perl configuration file.
+            </para>
             <indexterm zone="perl-log-log4perl l4p-templ-prog">
               <primary sortas="b-l4p-templ">l4p-templ</primary>

general/prog/perl-modules/perl-parse-yapp.xml

@@ -75 +75 @@
           <term><command>yapp</command></term>
           <listitem>
-            <para>is a frontend to the Parse::Yapp module, which lets you create
-            a Perl OO parser from an input grammar file.</para>
+            <para>
+              is a frontend to the Parse::Yapp module, which lets you create
+              a Perl OO parser from an input grammar file.
+            </para>
             <indexterm zone="perl-parse-yapp yapp-prog">
               <primary sortas="b-yapp">yapp</primary>

general/prog/perl-modules/perl-text-bibtex.xml

@@ -87 +87 @@
           <term><command>biblex</command></term>
           <listitem>
-            <para>performs lexical analysis on a BibTeX file.</para>
+            <para>
+              performs lexical analysis on a BibTeX file.
+            </para>
             <indexterm zone="perl-text-bibtex biblex-prog">
               <primary sortas="b-biblex">biblex</primary>
@@ -97 +99 @@
           <term><command>bibparse</command></term>
           <listitem>
-            <para>parses a series of BibTeX files with command line options to
-            control the string post-processing behaviour.</para>
+            <para>
+              parses a series of BibTeX files with command line options to
+              control the string post-processing behaviour.
+            </para>
             <indexterm zone="perl-text-bibtex bibparse-prog">
               <primary sortas="b-bibparse">bibparse</primary>
@@ -108 +112 @@
           <term><command>dumpnames</command></term>
           <listitem>
-            <para>parses a BibTeX file, splitting 'author' and 'editor' fields
-            into lists of names, and then dumps everything to stdout.</para>
+            <para>
+              parses a BibTeX file, splitting 'author' and 'editor' fields
+              into lists of names, and then dumps everything to stdout.
+            </para>
             <indexterm zone="perl-text-bibtex dumpnames-prog">
               <primary sortas="b-dumpnames">dumpnames</primary>
@@ -119 +125 @@
           <term><filename class='libraryfile'>libbtparse.so</filename></term>
           <listitem>
-            <para>is a library for parsing and processing BibTeX data files.</para>
+            <para>
+              is a library for parsing and processing BibTeX data files.
+            </para>
             <indexterm zone="perl-text-bibtex libbtparse-lib">
               <primary sortas="c-libbtparse">libbtparse.so</primary>

general/prog/prog.xml

@@ -16 +16 @@
   <title>Programming</title>
 
-  <para>A base LFS system can be used as a development
-  platform, however the base system only includes language support for
-  <application>C</application>, <application>C++</application> and
-  <application>Perl</application>. This chapter provides instructions to
-  build many popular programming environments to greatly expand your
-  system's development capabilities.</para>
+  <para>
+    A base LFS system can be used as a development
+    platform, however the base system only includes language support for
+    <application>C</application>, <application>C++</application> and
+    <application>Perl</application>. This chapter provides instructions to
+    build many popular programming environments to greatly expand your
+    system's development capabilities.
+  </para>
 
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="autoconf213.xml"/>
 <!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bazaar.xml"/> -->
       <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cbindgen.xml"/>
-<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="check.xml"/> -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="clisp.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cmake.xml"/>
-  <!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cvs.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cvsserver.xml"/>-->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dejagnu.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="doxygen.xml"/>
-<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="elfutils.xml"/> -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="expect.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc.xml"/>
-<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc-java.xml"/>-->
 <!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc-ada.xml"/> -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gc.xml"/>
@@ -48 +45 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="mercurial.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nasm.xml"/>
-<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ninja.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="npapi-sdk.xml"/> -->
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="perl-modules.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="perl-deps.xml"/>

general/prog/python2.xml

@@ -48 +48 @@
       </para>
         
-      <para> 
+      <para>
         BLFS is attempting to use Python3 as much as possible, but some
         packages have not been updated to support Python3.

general/prog/python3.xml

@@ -44 +44 @@
     </para>
 
-    <note><para><application>Python 3</application> was installed in LFS.
-    The only reason to rebuild it here is if optional modules
-    are needed.</para></note>
+    <note>
+      <para>
+        <application>Python 3</application> was installed in LFS.
+        The only reason to rebuild it here is if optional modules
+        are needed.
+      </para>
+    </note>
 
     &lfs91_checked;

general/prog/rust.xml

@@ -470 +470 @@
         If you installed <application>rustc</application> in
         <filename class="directory">/opt</filename>, you need to update the
-        following configuration files so that <application>rustc</application> is
-        correctly found by other packages and system processes.
+        following configuration files so that <application>rustc</application>
+        is correctly found by other packages and system processes.
       </para>
 
@@ -507 +507 @@
 EOF</userinput></screen>
 
-      <para>Immediately after installation, update the current PATH 
-      for your current shell as a normal user:</para>
+      <para>
+        Immediately after installation, update the current PATH 
+        for your current shell as a normal user:
+      </para>
 
 <screen><userinput>source /etc/profile.d/rustc.sh</userinput></screen>

general/prog/slang.xml

@@ -30 +30 @@
     <title>Introduction to slang</title>
 
-    <para><application>S-Lang</application> (slang) is an interpreted language
-    that may be embedded into an application to make the application
-    extensible.  It provides facilities required by interactive applications
-    such as display/screen management, keyboard input and keymaps.</para>
+    <para>
+      <application>S-Lang</application> (slang) is an interpreted language
+      that may be embedded into an application to make the application
+      extensible.  It provides facilities required by interactive applications
+      such as display/screen management, keyboard input and keymaps.
+    </para>
 
     &lfs91_checked;
@@ -40 +42 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&slang-download-http;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download (FTP): <ulink url="&slang-download-ftp;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download MD5 sum: &slang-md5sum;</para>
-      </listitem>
-      <listitem>
-        <para>Download size: &slang-size;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated disk space required: &slang-buildsize;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated build time: &slang-time;</para>
+        <para>
+          Download (HTTP): <ulink url="&slang-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&slang-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &slang-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &slang-size;</para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &slang-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &slang-time;</para>
       </listitem>
     </itemizedlist>
@@ -82 +90 @@
     </note>
 
-    <para>Install <application>slang</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>slang</application> by running the following
+      commands:
+    </para>
 
 <screen><userinput>./configure --prefix=/usr \
@@ -90 +100 @@
 make -j1</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>. Note that
-    this will also create a static version of the library which will then be
-    installed in the next step.</para>
-
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      To test the results, issue: <command>make check</command>. Note that
+      this will also create a static version of the library which will then be
+      installed in the next step.
+    </para>
+
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role='root'><userinput>make install_doc_dir=/usr/share/doc/slang-&slang-version;   \
@@ -113 +127 @@
     </para>
 
-    <para><command>make install_doc_dir=/usr/share/doc/slang-&slang-version;
-    SLSH_DOC_DIR=/usr/share/doc/slang-&slang-version;/slsh install-all</command>:
-    This command installs the static library as well as
-    the dynamic shared version and related modules. It also changes the
-    documentation installation directories to a versioned directory.</para>
+    <para>
+      <command>make install_doc_dir=/usr/share/doc/slang-&slang-version;
+      SLSH_DOC_DIR=/usr/share/doc/slang-&slang-version;/slsh install-all</command>:
+      This command installs the static library as well as
+      the dynamic shared version and related modules. It also changes the
+      documentation installation directories to a versioned directory.
+    </para>
 
   </sect2>
@@ -126 +142 @@
     <sect3 id="slang-config">
       <title>Config Files</title>
-      <para><filename>~/.slshrc</filename> and
-      <filename>/etc/slsh.rc</filename></para>
+      <para>
+        <filename>~/.slshrc</filename> and
+        <filename>/etc/slsh.rc</filename>
+      </para>
 
       <indexterm zone="slang slang-config">
@@ -164 +182 @@
         <term><command>slsh</command></term>
         <listitem>
-          <para>is a simple program for interpreting
-          <application>slang</application> scripts. It supports dynamic loading
-          of <application>slang</application> modules and includes a
-          <application>Readline</application> interface for interactive
-          use.</para>
+          <para>
+            is a simple program for interpreting
+            <application>slang</application> scripts. It supports dynamic
+            loading of <application>slang</application> modules and includes a
+            <application>Readline</application> interface for interactive use.
+          </para>
           <indexterm zone="slang slsh">
             <primary sortas="b-slsh">slsh</primary>

general/prog/svnserver.xml

@@ -19 +19 @@
     <title>Running a Subversion Server</title>
 
-    <para>This section will describe how to set up, administer and secure
-    a <application>Subversion</application> server.</para>
+    <para>
+      This section will describe how to set up, administer and secure
+      a <application>Subversion</application> server.
+    </para>
 
     <bridgehead renderas="sect3">Subversion Server Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
-    <para><xref linkend="subversion"/> and
-    <xref linkend="openssh"/></para>
+    <para role="required">
+      <xref linkend="subversion"/> and
+      <xref linkend="openssh"/>
+    </para>
 
   </sect2>
@@ -33 +37 @@
     <title>Setting up a Subversion Server.</title>
 
-    <para>The following instructions will install a
-    <application>Subversion</application> server, which will be set up
-    to use <application>OpenSSH</application> as the secure remote access
-    method, with <command>svnserve</command> available for anonymous
-    access.</para>
-
-    <para>Configuration of the <application>Subversion</application> server
-    consists of the following steps:</para>
+    <para>
+      The following instructions will install a
+      <application>Subversion</application> server, which will be set up
+      to use <application>OpenSSH</application> as the secure remote access
+      method, with <command>svnserve</command> available for anonymous
+      access.
+    </para>
+
+    <para>
+      Configuration of the <application>Subversion</application> server
+      consists of the following steps:
+    </para>
 
     <sect3>
       <title>1. Setup Users, Groups, and Permissions</title>
 
-      <para>You'll need to be user
-      <systemitem class='username'>root</systemitem> for the initial portion of
-      configuration. Create the <systemitem class="username">svn</systemitem>
-      user and group with the following commands:</para>
+      <para>
+        You'll need to be user
+        <systemitem class='username'>root</systemitem> for the initial portion
+        of configuration. Create the <systemitem
+        class="username">svn</systemitem> user and group with the following
+        commands:
+      </para>
 
 <screen role="root"><userinput>groupadd -g 56 svn &amp;&amp;
 useradd -c "SVN Owner" -d /home/svn -m -g svn -s /bin/false -u 56 svn</userinput></screen>
 
-      <para>If you plan to have multiple repositories, you should have a
-      group dedicated to each repository for ease of administration. Create
-      the <systemitem class="groupname">svntest</systemitem> group for the test
-      repository and add the <systemitem class="username">svn</systemitem>
-      user to that group with the following commands:</para>
+      <para>
+        If you plan to have multiple repositories, you should have a
+        group dedicated to each repository for ease of administration. Create
+        the <systemitem class="groupname">svntest</systemitem> group for the
+        test repository and add the <systemitem
+        class="username">svn</systemitem> user to that group with the
+        following commands:
+      </para>
 
 <screen role="root"><userinput>groupadd -g 57 svntest &amp;&amp;
 usermod -G svntest -a svn</userinput></screen>
 
-      <para>Additionally you should set <command>umask 002</command> while
-      working with a repository so that all new files will be writable by
-      owner and group. This is made mandatory by creating a wrapper script for
-      <command>svn</command> and <command>svnserve</command>:</para>
+      <para>
+        Additionally you should set <command>umask 002</command> while
+        working with a repository so that all new files will be writable by
+        owner and group. This is made mandatory by creating a wrapper script
+        for <command>svn</command> and <command>svnserve</command>:
+      </para>
 
 <screen role="root"><userinput>mv /usr/bin/svn /usr/bin/svn.orig &amp;&amp;
@@ -82 +98 @@
 
       <note>
-        <para>If you use <application>Apache</application> for working with
-        the repository over HTTP, even for anonymous access, you should wrap
-        <command>/usr/sbin/httpd</command> in a similar script.</para>
+        <para>
+          If you use <application>Apache</application> for working with
+          the repository over HTTP, even for anonymous access, you should wrap
+          <command>/usr/sbin/httpd</command> in a similar script.
+        </para>
       </note>
 
@@ -110 +128 @@
 svnadmin create /srv/svn/repositories/svntest</userinput></screen>
 
-      <para>Now that the repository is created, it should be populated with
-      something useful. You'll need to have a predefined directory
-      layout set up exactly as you want your repository to look. For
-      example, here is a sample BLFS layout setup with a root of
-      <filename>svntest/</filename>. You'll need to setup a directory
-      tree similar to the following:</para>
+      <para>
+        Now that the repository is created, it should be populated with
+        something useful. You'll need to have a predefined directory
+        layout set up exactly as you want your repository to look. For
+        example, here is a sample BLFS layout setup with a root of
+        <filename>svntest/</filename>. You'll need to setup a directory
+        tree similar to the following:
+      </para>
 
 <screen><literal>svntest/            # The name of the repository
@@ -127 +147 @@
    tags/            # Needed for tagging release points</literal></screen>
 
-      <para>Once you've created your directory layout as shown above, you
-      are ready to do the initial import:</para>
+      <para>
+        Once you've created your directory layout as shown above, you
+        are ready to do the initial import:
+      </para>
 
 <screen role="root"><userinput>svn import -m "Initial import." \
@@ -134 +156 @@
     file:///srv/svn/repositories/svntest</userinput></screen>
 
-      <para>Now change owner and group information on the
-      repository, and add an unprivileged user to the
-      <systemitem class="groupname">svn</systemitem> and
-      <systemitem class="groupname">svntest</systemitem> groups:</para>
+      <para>
+        Now change owner and group information on the
+        repository, and add an unprivileged user to the
+        <systemitem class="groupname">svn</systemitem> and
+        <systemitem class="groupname">svntest</systemitem> groups:
+      </para>
 
 <screen role="root"><userinput>chown -R svn:svntest /srv/svn/repositories/svntest    &amp;&amp;
@@ -144 +168 @@
 usermod -G svn,svntest -a <replaceable>&lt;username&gt;</replaceable></userinput></screen>
 
-      <para><systemitem class="groupname">svntest</systemitem> is the group
-      assigned to the svntest repository. As mentioned earlier, this eases
-      administration of multiple repositories when using
-      <application>OpenSSH</application> for authentication. Going forward,
-      you'll need to add your unprivileged user, and any additional users that
-      you wish to have write access to the repository, to the
-      <systemitem class="groupname">svn</systemitem> and
-      <systemitem class="groupname">svntest</systemitem> groups.</para>
-
-      <para>In addition, you'll notice that the new repository's
-      <filename>db</filename> directory is set-groupID. If the reasoning is
-      not immediately obvious, when using any external authentication method
-      (such as <command>ssh</command>), the sticky bit is set so that all
-      new files will be owned by the user, but group of
-      <systemitem class="groupname">svntest</systemitem>. Anyone in the
-      <systemitem class="groupname">svntest</systemitem> group can create
-      files, but still give the entire group write access to those
-      files. This avoids locking out other users from the repository.</para>
-
-      <para>Now, return to an unprivileged user account, and take a
-      look at the new repository using <command>svnlook</command>:</para>
+      <para>
+        <systemitem class="groupname">svntest</systemitem> is the group
+        assigned to the svntest repository. As mentioned earlier, this eases
+        administration of multiple repositories when using
+        <application>OpenSSH</application> for authentication. Going forward,
+        you'll need to add your unprivileged user, and any additional users
+        that you wish to have write access to the repository, to the
+        <systemitem class="groupname">svn</systemitem> and <systemitem
+        class="groupname">svntest</systemitem> groups.
+      </para>
+
+      <para>
+        In addition, you'll notice that the new repository's
+        <filename>db</filename> directory is set-groupID. If the reasoning is
+        not immediately obvious, when using any external authentication method
+        (such as <command>ssh</command>), the sticky bit is set so that all
+        new files will be owned by the user, but group of
+        <systemitem class="groupname">svntest</systemitem>. Anyone in the
+        <systemitem class="groupname">svntest</systemitem> group can create
+        files, but still give the entire group write access to those
+        files. This avoids locking out other users from the repository.
+      </para>
+
+      <para>
+        Now, return to an unprivileged user account, and take a
+        look at the new repository using <command>svnlook</command>:
+      </para>
 
 <screen><userinput>svnlook tree /srv/svn/repositories/svntest/</userinput></screen>
 
       <note>
-        <para>You may need to log out and back in again to refresh your group
-        memberships. '<command>su <replaceable>&lt;username&gt;</replaceable></command>'
-        should work as well.</para>
+        <para>
+          You may need to log out and back in again to refresh your group
+          memberships. <command>su
+          <replaceable>&lt;username&gt;</replaceable></command>
+          should work as well.
+        </para>
       </note>
 
@@ -179 +212 @@
       <title>3. Configure the Server</title>
 
-      <para>As mentioned previously, these instructions will configure the
-      server to use only <command>ssh</command> for write access to the
-      repository and to provide anonymous access using
-      <command>svnserve</command>. There are several other ways to provide
-      access to the repository. These additional configurations are best
-      explained at <ulink url="http://svnbook.red-bean.com/"/>.</para>
-
-      <para>Access configuration needs to be done for each repository.
-      Create the <filename>svnserve.conf</filename> file for the svntest
-      repository using the following commands:</para>
+      <para>
+        As mentioned previously, these instructions will configure the
+        server to use only <command>ssh</command> for write access to the
+        repository and to provide anonymous access using
+        <command>svnserve</command>. There are several other ways to provide
+        access to the repository. These additional configurations are best
+        explained at <ulink url="http://svnbook.red-bean.com/"/>.
+      </para>
+
+      <para>
+        Access configuration needs to be done for each repository.
+        Create the <filename>svnserve.conf</filename> file for the svntest
+        repository using the following commands:
+      </para>
 
 <screen role="root"><userinput>cp /srv/svn/repositories/svntest/conf/svnserve.conf \
@@ -199 +236 @@
 EOF</userinput></screen>
 
-      <para>There is not a lot to the configuration file at all. You'll
-      notice that only the general section is required. Take a look at the
-      <filename>svnserve.conf.default</filename> file for information on using
-      <command>svnserve</command>'s built-in authentication method.</para>
+      <para>
+        There is not a lot to the configuration file at all. You'll notice
+        that only the general section is required. Take a look at the
+        <filename>svnserve.conf.default</filename> file for information on
+        using <command>svnserve</command>'s built-in authentication method.
+      </para>
 
     </sect3>
@@ -209 +248 @@
       <title>4. Starting the Server</title>
 
-      <para revision="sysv">To start the server at boot time, install the svn
-      bootscript included in the <xref linkend="bootscripts"/> package.</para>
-
-      <para revision="systemd">To start the server at boot time, install the
-      <filename>svnserve.service</filename> unit from the 
-      <xref linkend="systemd-units"/> package.</para>
+      <para revision="sysv">
+        To start the server at boot time, install the svn
+        bootscript included in the <xref linkend="bootscripts"/> package:
+      </para>
+
+      <para revision="systemd">
+        To start the server at boot time, install the
+        <filename>svnserve.service</filename> unit from the 
+        <xref linkend="systemd-units"/> package:
+      </para>
 
       <indexterm zone="svnserver svnserver-init" revision="sysv">
@@ -228 +271 @@
 <screen role="root" revision="systemd"><userinput>make install-svnserve</userinput></screen>
 
-      <para revision="systemd">Additionally, the instructions above require
-      that svn server uses <command>umask 002</command> so that all new files
-      will be writable by owner and group. This can be achieved by creating
-      a systemd unit override file by running the following command:</para>
+      <para revision="systemd">
+        Additionally, the instructions above require
+        that svn server uses <command>umask 002</command> so that all new files
+        will be writable by owner and group. This can be achieved by creating
+        a systemd unit override file by running the following command:
+      </para>
 
 <screen role="root" revision="systemd"><userinput>mkdir -p /etc/systemd/system/svnserve.service.d 
 echo "UMask=0002" > /etc/systemd/system/svnserve.service.d/99-user.conf</userinput></screen>
 
-      <para revision="systemd">Options which are passed to
-      <command>svnserve</command> daemon can be changed in
-      <filename>/etc/default/svnserve</filename>.</para>
+      <para revision="systemd">
+        Options which are passed to
+        <command>svnserve</command> daemon can be changed in
+        <filename>/etc/default/svnserve</filename>.
+      </para>
 
     </sect3>

general/prog/vala.xml

@@ -112 +112 @@
     <title>Installation of Vala</title>
 
-    <para>Install <application>Vala</application> by running the following
-    commands:</para>
-<!--
-    <note>
-      <para>If the recommended dependency <xref linkend="graphviz"/> is not
-      installed, apply a patch. This will prevent building the valadoc program
-      and libraries that can be used to generate API documentation in HTML format
-      from Vala source code.
-      </para>
-
-<screen><userinput>patch -p1 -i ../vala-&vala-version;-avoid_graphviz-1.patch &amp;&amp;
-ACLOCAL= autoreconf -fiv</userinput></screen>
-    </note>
--->
+    <para>
+      Install <application>Vala</application> by running the following
+      commands:
+    </para>
+
 <screen><userinput>./configure --prefix=/usr &amp;&amp;
 make</userinput></screen>
@@ -221 +212 @@
       </varlistentry>
 
-<!--
-      <varlistentry id="vapicheck">
-        <term><command>vapicheck</command></term>
-        <listitem>
-          <para>
-            verifies the generated bindings.
-          </para>
-          <indexterm zone="vala vapicheck">
-            <primary sortas="b-vapicheck">vapicheck</primary>
-          </indexterm>
-        </listitem>
-      </varlistentry>-->
-
       <varlistentry id="vapigen">
         <term><command>vapigen</command></term>

general/prog/yasm.xml

@@ -30 +30 @@
     <title>Introduction to yasm</title>
 
-    <para><application>Yasm</application> is a complete rewrite of the
-    <xref linkend="nasm"/> assembler. It supports the x86 and AMD64 instruction
-    sets, accepts NASM and GAS assembler syntaxes and outputs binary, ELF32 and
-    ELF64 object formats.</para>
+    <para>
+      <application>Yasm</application> is a complete rewrite of the
+      <xref linkend="nasm"/> assembler. It supports the x86 and AMD64
+      instruction sets, accepts NASM and GAS assembler syntaxes and outputs
+      binary, ELF32 and ELF64 object formats.
+    </para>
 
     &lfs91_checked;
@@ -40 +42 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&yasm-download-http;"/></para>
+        <para>
+          Download (HTTP): <ulink url="&yasm-download-http;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download (FTP): <ulink url="&yasm-download-ftp;"/></para>
+        <para>
+          Download (FTP): <ulink url="&yasm-download-ftp;"/>
+        </para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum: &yasm-md5sum;</para>
+        <para>
+          Download MD5 sum: &yasm-md5sum;
+        </para>
       </listitem>
       <listitem>
-        <para>Download size: &yasm-size;</para>
+        <para>
+          Download size: &yasm-size;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated disk space required: &yasm-buildsize;</para>
+        <para>
+          Estimated disk space required: &yasm-buildsize;
+        </para>
       </listitem>
       <listitem>
-        <para>Estimated build time: &yasm-time;</para>
+        <para>
+          Estimated build time: &yasm-time;
+        </para>
       </listitem>
     </itemizedlist>
@@ -75 +89 @@
     <title>Installation of yasm</title>
 
-    <para>Install <application>yasm</application> by running the following
-    commands:</para>
+    <para>
+      Install <application>yasm</application> by running the following
+      commands:
+    </para>
 
 <screen><userinput>sed -i 's#) ytasm.*#)#' Makefile.in &amp;&amp;
@@ -83 +99 @@
 make</userinput></screen>
 
-    <para>To test the results, issue: <command>make check</command>.</para>
+    <para>
+      To test the results, issue: <command>make check</command>.
+    </para>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -94 +114 @@
     <title>Command Explanations</title>
 
-    <para><command>sed -i 's#) ytasm.*#)#' Makefile.in</command>: This sed
-    prevents it compiling 2 programs (vsyasm and ytasm) that are only of use
-    on Microsoft Windows.</para>
+    <para>
+      <command>sed -i 's#) ytasm.*#)#' Makefile.in</command>: This sed
+      prevents it compiling 2 programs (vsyasm and ytasm) that are only of use
+      on Microsoft Windows.
+    </para>
 
   </sect2>
@@ -123 +145 @@
         <term><command>yasm</command></term>
         <listitem>
-          <para>is a portable, retargetable assembler that supports the x86 and
-          AMD64 instruction sets, accepts NASM and GAS assembler syntaxes and
-          outputs binaries in ELF32 and ELF64 object formats.</para>
+          <para>
+            is a portable, retargetable assembler that supports the x86 and
+            AMD64 instruction sets, accepts NASM and GAS assembler syntaxes and
+            outputs binaries in ELF32 and ELF64 object formats.
+          </para>
           <indexterm zone="yasm yasm">
             <primary sortas="b-yasm">yasm</primary>
@@ -135 +159 @@
         <term><filename class='libraryfile'>libyasm.a</filename></term>
         <listitem>
-          <para>provides all of the core functionality of
-          <command>yasm</command>, for manipulating machine instructions and
-          object file constructs.</para>
+          <para>
+            provides all of the core functionality of <command>yasm</command>,
+            for manipulating machine instructions and object file constructs.
+          </para>
           <indexterm zone="yasm libyasm">
             <primary sortas="c-libyasm">libyasm.a</primary>