Changeset df5d0e3

Timestamp:

12/06/2022 11:30:12 PM (17 months ago)

Author:

Thomas Trepl <thomas@…>

Branches:

multilib

Children:

156a414e

Parents:

7b4ec84 (diff), 8f10e6fa (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Automatic merge of trunk into multilib

Location:

chapter08

Files:

• bash.xml (modified) (2 diffs)
• gdbm.xml (modified) (1 diff)
• gettext.xml (modified) (4 diffs)
• libelf.xml (modified) (2 diffs)
• libtool.xml (modified) (4 diffs)
• openssl.xml (modified) (1 diff)
• perl.xml (modified) (10 diffs)

chapter08/bash.xml

@@ -24 +24 @@
     <title/>
 
-    <para>The Bash package contains the Bourne-Again SHell.</para>
+    <para>The Bash package contains the Bourne-Again Shell.</para>
 
     <segmentedlist>
@@ -74 +74 @@
 <screen><userinput remap="test">chown -Rv tester .</userinput></screen>
 
-    <para>The testsuite of the package is designed to be run as a non-&root;
-    user that owns the terminal connected to standard input.  To satisfy the
+    <para>The test suite of this package is designed to be run as a non-&root;
+    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

chapter08/gdbm.xml

@@ -25 +25 @@
 
     <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

chapter08/gettext.xml

@@ -347 +347 @@
         <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
@@ -360 +360 @@
         <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">
@@ -386 +386 @@
         <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">
@@ -407 +407 @@
         <term><filename class="libraryfile">preloadable_libintl</filename></term>
         <listitem>
-          <para>A library, intended to be used by LD_PRELOAD that assists
-          <filename class="libraryfile">libintl</filename> in logging
+          <para>A library, intended to be used by LD_PRELOAD, that helps
+          <filename class="libraryfile">libintl</filename> log
           untranslated messages</para>
           <indexterm zone="ch-system-gettext preloadable_libintl">

chapter08/libelf.xml

@@ -42 +42 @@
     <title>Installation of Libelf</title>
 
-      <para>Libelf is part of elfutils-&elfutils-version; package. Use
-      the elfutils-&elfutils-version;.tar.bz2 as the source tarball.</para>
+      <para>Libelf is part of the elfutils-&elfutils-version; package. Use
+      the elfutils-&elfutils-version;.tar.bz2 file as the source tarball.</para>
 
     <para>Prepare Libelf for compilation:</para>
@@ -60 +60 @@
 
     <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

@@ -25 +25 @@
 
     <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>
 
@@ -55 +55 @@
 <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
@@ -63 +63 @@
     <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>
 
@@ -183 +183 @@
         <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>

chapter08/openssl.xml

@@ -90 +90 @@
         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
-        unchanged</emphasis>.
+        <emphasis>when upgrading to a version with the same MAJOR version
+        number</emphasis>.
       </para>
 

chapter08/perl.xml

@@ -47 +47 @@
 <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.
@@ -58 +58 @@
     <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>
 
@@ -83 +83 @@
         <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>
@@ -100 +100 @@
         <listitem>
           <para>Since Groff is not installed yet, <command>Configure</command>
-          thinks that we do not want man pages for Perl.  Issuing these
-          parameters overrides this decision.</para>
+          will not create man pages for Perl.  These
+          parameters override this behavior.</para>
         </listitem>
       </varlistentry>
@@ -108 +108 @@
         <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>
@@ -115 +115 @@
         <term><parameter>-Dusethreads</parameter></term>
         <listitem>
-          <para>Build perl with support for threads.</para>
+          <para>Build Perl with support for threads.</para>
         </listitem>
       </varlistentry>
@@ -122 +122 @@
         <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>
@@ -186 +186 @@
         <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>
@@ -251 +251 @@
         <term><command>instmodsh</command></term>
         <listitem>
-          <para>Shell script for examining installed Perl modules,
-          and can create a tarball from an installed module</para>
+          <para>Shell script for examining installed Perl modules;
+          it can create a tarball from an installed module</para>
           <indexterm zone="ch-system-perl instmodsh">
             <primary sortas="b-instmodsh">instmodsh</primary>
@@ -285 +285 @@
           <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>