diff --git a/chapter08/bash.xml b/chapter08/bash.xml index 4ea981d5b..a004f7ac3 100644 --- a/chapter08/bash.xml +++ b/chapter08/bash.xml @@ -23,7 +23,7 @@ - <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; - 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 class="username">tester</systemitem> user:</para> diff --git a/chapter08/gdbm.xml b/chapter08/gdbm.xml index 431987f52..80961a65d 100644 --- a/chapter08/gdbm.xml +++ b/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> diff --git a/chapter08/gettext.xml b/chapter08/gettext.xml index 08b960d44..be1c16d39 100644 --- a/chapter08/gettext.xml +++ b/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><string></emphasis> strings and the <emphasis><iostream></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 - <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"> <primary sortas="c-preloadable_libintl">preloadable_libintl</primary> diff --git a/chapter08/libelf.xml b/chapter08/libelf.xml index 4d3332fd1..eec399e41 100644 --- a/chapter08/libelf.xml +++ b/chapter08/libelf.xml @@ -41,8 +41,8 @@ <sect2 role="installation"> <title>Installation of Libelf - Libelf is part of elfutils-&elfutils-version; package. Use - the elfutils-&elfutils-version;.tar.bz2 as the source tarball. + Libelf is part of the elfutils-&elfutils-version; package. Use + the elfutils-&elfutils-version;.tar.bz2 file as the source tarball. Prepare Libelf for compilation: @@ -59,7 +59,7 @@ make check One test named run-low_high_pc.sh is known to - fail on 32-bit x86 system. + fail on 32-bit x86 systems. Install only Libelf: diff --git a/chapter08/libtool.xml b/chapter08/libtool.xml index 4881b2b29..f6b9afb67 100644 --- a/chapter08/libtool.xml +++ b/chapter08/libtool.xml @@ -24,7 +24,7 @@ <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<N></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> diff --git a/chapter08/openssl.xml b/chapter08/openssl.xml index a84dbfd17..4d7a17b12 100644 --- a/chapter08/openssl.xml +++ b/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 - unchanged</emphasis>. + <emphasis>when upgrading to a version with the same MAJOR version + number</emphasis>. </para> <para> diff --git a/chapter08/perl.xml b/chapter08/perl.xml index 461eb7980..112780c4a 100644 --- a/chapter08/perl.xml +++ b/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 - parameters overrides this decision.</para> + will not create man pages for Perl. These + 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, - 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> </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>