Automatic merge of trunk into multilib

chapter08/bash.xml

@@ -23,7 +23,7 @@
   <sect2 role="package">
     <title/>
 
-    <para>The Bash package contains the Bourne-Again SHell.</para>
+    <para>The Bash package contains the Bourne-Again Shell.</para>
 
     <segmentedlist>
       <segtitle>&buildtime;</segtitle>
@@ -73,8 +73,8 @@
 
 <screen><userinput remap="test">chown -Rv tester .</userinput></screen>
 
-    <para>The testsuite of the package is designed to be run as a non-&root;
+    <para>The test suite of this package is designed to be run as a non-&root;
-    user that owns the terminal connected to standard input.  To satisfy the
+    user who owns the terminal connected to standard input.  To satisfy the
     requirement, spawn a new pseudo terminal using
     <application>Expect</application> and run the tests as the <systemitem
     class="username">tester</systemitem> user:</para>

chapter08/gdbm.xml

@@ -24,7 +24,7 @@
     <title/>
 
     <para>The GDBM package contains the GNU Database Manager.  It is a library
-    of database functions that use extensible hashing and works similar to the
+    of database functions that uses extensible hashing and works like the
     standard UNIX dbm.  The library provides primitives for storing key/data
     pairs, searching and retrieving the data by its key and deleting a key
     along with its data. </para>

chapter08/gettext.xml

@@ -346,7 +346,7 @@ chmod -v 0755 /usr/lib/preloadable_libintl.so</userinput></screen>
       <varlistentry id="libasprintf">
         <term><filename class="libraryfile">libasprintf</filename></term>
         <listitem>
-          <para>defines the <emphasis>autosprintf</emphasis> class, which makes
+          <para>Defines the <emphasis>autosprintf</emphasis> class, which makes
           C formatted output routines usable in C++ programs, for use with the
           <emphasis>&lt;string&gt;</emphasis> strings and the
           <emphasis>&lt;iostream&gt;</emphasis> streams</para>
@@ -359,7 +359,7 @@ chmod -v 0755 /usr/lib/preloadable_libintl.so</userinput></screen>
       <varlistentry id="libgettextlib">
         <term><filename class="libraryfile">libgettextlib</filename></term>
         <listitem>
-          <para>a private library containing common routines used by the
+          <para>Contains common routines used by the
           various Gettext programs; these are not intended for general use</para>
           <indexterm zone="ch-system-gettext libgettextlib">
             <primary sortas="c-libgettextlib">libgettextlib</primary>
@@ -385,7 +385,7 @@ chmod -v 0755 /usr/lib/preloadable_libintl.so</userinput></screen>
       <varlistentry id="libgettextsrc">
         <term><filename class="libraryfile">libgettextsrc</filename></term>
         <listitem>
-          <para>A private library containing common routines used by the
+          <para>Provides common routines used by the
           various Gettext programs; these are not intended for general use</para>
           <indexterm zone="ch-system-gettext libgettextsrc">
             <primary sortas="c-libgettextsrc">libgettextsrc</primary>
@@ -406,8 +406,8 @@ chmod -v 0755 /usr/lib/preloadable_libintl.so</userinput></screen>
       <varlistentry id="preloadable_libintl">
         <term><filename class="libraryfile">preloadable_libintl</filename></term>
         <listitem>
-          <para>A library, intended to be used by LD_PRELOAD that assists
+          <para>A library, intended to be used by LD_PRELOAD, that helps
-          <filename class="libraryfile">libintl</filename> in logging
+          <filename class="libraryfile">libintl</filename> log
           untranslated messages</para>
           <indexterm zone="ch-system-gettext preloadable_libintl">
             <primary sortas="c-preloadable_libintl">preloadable_libintl</primary>

chapter08/libelf.xml

@@ -41,8 +41,8 @@
   <sect2 role="installation">
     <title>Installation of Libelf</title>
 
-      <para>Libelf is part of elfutils-&elfutils-version; package. Use
+      <para>Libelf is part of the elfutils-&elfutils-version; package. Use
-      the elfutils-&elfutils-version;.tar.bz2 as the source tarball.</para>
+      the elfutils-&elfutils-version;.tar.bz2 file as the source tarball.</para>
 
     <para>Prepare Libelf for compilation:</para>
 
@@ -59,7 +59,7 @@
 <screen><userinput remap="test">make check</userinput></screen>
 
     <para>One test named <filename>run-low_high_pc.sh</filename> is known to
-    fail on 32-bit x86 system.</para>
+    fail on 32-bit x86 systems.</para>
 
     <para>Install only Libelf:</para>
 

chapter08/libtool.xml

@@ -24,7 +24,7 @@
     <title/>
 
     <para>The Libtool package contains the GNU generic library support script.
-    It wraps the complexity of using shared libraries in a consistent, portable
+    It makes the use of shared libraries simpler with a consistent, portable
     interface.</para>
 
     <segmentedlist>
@@ -54,7 +54,7 @@
 
 <screen><userinput remap="test">make -k check</userinput></screen>
 
-    <note><para>The test time for libtool can be reduced significantly on a
+    <note><para>The test time for Libtool can be reduced significantly on a
     system with multiple cores.  To do this, append
     <command>TESTSUITEFLAGS=-j&lt;N&gt;</command> to the line above.  For
     instance, using -j4 can reduce the test time by over 60
@@ -62,7 +62,7 @@
 
     <para>Five tests are known to fail in the LFS build environment due
     to a circular dependency, but these tests pass if rechecked after
-    automake is installed.  Additionally, with grep-3.8, two tests will
+    automake has been installed.  Additionally, with grep-3.8, two tests will
     trigger a warning for non-POSIX regular expressions and fail.</para>
 
     <para>Install the package:</para>
@@ -182,7 +182,7 @@ rm -rf DESTDIR</userinput></screen>
       <varlistentry id="libltdl">
         <term><filename class="libraryfile">libltdl</filename></term>
         <listitem>
-          <para>Hides the various difficulties of dlopening libraries</para>
+          <para>Hides the various difficulties of opening dynamically linked libraries</para>
           <indexterm zone="ch-system-libtool libltdl">
             <primary sortas="c-libltdl">libltdl</primary>
           </indexterm>

chapter08/openssl.xml

@@ -89,13 +89,13 @@ make MANSUFFIX=ssl install</userinput></screen>
         You should update OpenSSL when a new version which fixes vulnerabilities
         is announced.  Since OpenSSL 3.0.0, the OpenSSL versioning scheme
         follows the MAJOR.MINOR.PATCH format.  API/ABI compatibility
-        are guaranteed for the same MAJOR version number.  Because LFS
+        is guaranteed for the same MAJOR version number.  Because LFS
         installs only the shared libraries, there is no need to recompile
         packages which link to
         <filename class="libraryfile">libcrypto.so</filename> or
         <filename class="libraryfile">libssl.so</filename>
-        <emphasis>when upgrading to a version with MAJOR version number
+        <emphasis>when upgrading to a version with the same MAJOR version
-        unchanged</emphasis>.
+        number</emphasis>.
       </para>
 
       <para>

chapter08/perl.xml

@@ -46,7 +46,7 @@
 
 <screen><userinput remap="pre">patch -Np1 -i ../&perl-fix-patch;</userinput></screen>
 -->
-    <para>This version of Perl now builds the Compress::Raw::Zlib and
+    <para>This version of Perl builds the Compress::Raw::Zlib and
     Compress::Raw::BZip2 modules. By
     default Perl will use an internal copy of the sources for the build.
     Issue the following command so that Perl will use the libraries
@@ -57,7 +57,7 @@ export BUILD_BZIP2=0</userinput></screen>
 
     <para>To have full control over the way Perl is set up, you can remove the
     <quote>-des</quote> options from the following command and hand-pick the way
-    this package is built. Alternatively, use the command exactly as below to
+    this package is built. Alternatively, use the command exactly as shown below to
     use the defaults that Perl auto-detects:</para>
 
  <screen><userinput remap="configure">sh Configure -des                                         \
@@ -82,7 +82,7 @@ export BUILD_BZIP2=0</userinput></screen>
         <term><parameter>-Dvendorprefix=/usr</parameter></term>
         <listitem>
           <para>This ensures <command>perl</command> knows how to
-          tell packages where they should install their perl modules.</para>
+          tell packages where they should install their Perl modules.</para>
         </listitem>
       </varlistentry>
 
@@ -99,33 +99,33 @@ export BUILD_BZIP2=0</userinput></screen>
         -Dman3dir=/usr/share/man/man3</parameter></term>
         <listitem>
           <para>Since Groff is not installed yet, <command>Configure</command>
-          thinks that we do not want man pages for Perl.  Issuing these
+          will not create man pages for Perl.  These
-          parameters overrides this decision.</para>
+          parameters override this behavior.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><parameter>-Duseshrplib</parameter></term>
         <listitem>
-          <para>Build a shared libperl needed by some perl modules.</para>
+          <para>Build a shared libperl needed by some Perl modules.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><parameter>-Dusethreads</parameter></term>
         <listitem>
-          <para>Build perl with support for threads.</para>
+          <para>Build Perl with support for threads.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term><parameter>-Dprivlib,-Darchlib,-Dsitelib,...</parameter></term>
         <listitem>
-          <para>These settings define where Perl is looking for installed
+          <para>These settings define where Perl looks for installed
           modules. The LFS editors chose to put them in a directory structure
           based on the Major.Minor version of Perl (&perl-version-min;) which
           allows upgrading Perl to newer Patch levels (&perl-version;) without
-          the need to reinstall all of the modules again.</para>
+          reinstalling all of the modules.</para>
         </listitem>
       </varlistentry>
 
@@ -185,7 +185,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="corelist">
         <term><command>corelist</command></term>
         <listitem>
-          <para>A commandline frontend to Module::CoreList</para>
+          <para>A command line front end to Module::CoreList</para>
           <indexterm zone="ch-system-perl corelist">
             <primary sortas="b-corelist">corelist</primary>
           </indexterm>
@@ -250,8 +250,8 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
       <varlistentry id="instmodsh">
         <term><command>instmodsh</command></term>
         <listitem>
-          <para>Shell script for examining installed Perl modules,
+          <para>Shell script for examining installed Perl modules;
-          and can create a tarball from an installed module</para>
+          it can create a tarball from an installed module</para>
           <indexterm zone="ch-system-perl instmodsh">
             <primary sortas="b-instmodsh">instmodsh</primary>
           </indexterm>
@@ -284,7 +284,7 @@ unset BUILD_ZLIB BUILD_BZIP2</userinput></screen>
         <listitem>
           <para>Combines some of the best features of C, <command>sed</command>,
           <command>awk</command> and <command>sh</command> into a single
-          swiss-army language</para>
+          Swiss Army language</para>
           <indexterm zone="ch-system-perl perl">
             <primary sortas="b-perl">perl</primary>
           </indexterm>