Merge remote-tracking branch 'origin/trunk' into xry111/arm64

chapter08/coreutils.xml

@@ -23,8 +23,8 @@
   <sect2 role="package">
     <title/>
 
-    <para>The Coreutils package contains utilities for showing and setting the
+    <para>The Coreutils package contains the basic utility programs
-    basic system characteristics.</para>
+    needed by every operating system.</para>
 
     <segmentedlist>
       <segtitle>&buildtime;</segtitle>
@@ -48,9 +48,9 @@
 <screen><userinput remap="pre">patch -Np1 -i ../&coreutils-i18n-patch;</userinput></screen>
 
     <note>
-      <para>In the past, many bugs were found in this patch. When reporting new
+      <para>Many bugs have been found in this patch. When reporting new
-      bugs to Coreutils maintainers, please check first if they are reproducible
+      bugs to the Coreutils maintainers, please check first to see if 
-      without this patch.</para>
+      those bugs are reproducible without this patch.</para>
     </note>
 
    <!-- this has been fixed in upstream gnulib, when a new version of
@@ -75,8 +75,8 @@ FORCE_UNSAFE_CONFIGURE=1 ./configure \
         <term><command>autoreconf</command></term>
         <listitem>
           <para>The patch for internationalization has modified the
-          building system of the package, so the configuration files have
+          build system, so the configuration files must
-          to be regenerated.</para>
+          be regenerated.</para>
         </listitem>
       </varlistentry>
 
@@ -84,7 +84,7 @@ FORCE_UNSAFE_CONFIGURE=1 ./configure \
         <term><envar>FORCE_UNSAFE_CONFIGURE=1</envar></term>
         <listitem>
           <para>This environment variable allows the package to be
-          built as the <systemitem class="username">root</systemitem> user.
+          built by the <systemitem class="username">root</systemitem> user.
           </para>
         </listitem>
       </varlistentry>
@@ -93,7 +93,7 @@ FORCE_UNSAFE_CONFIGURE=1 ./configure \
         <term><parameter>--enable-no-install-program=kill,uptime</parameter></term>
         <listitem>
           <para>The purpose of this switch is to prevent Coreutils from
-          installing binaries that will be installed by other packages later.
+          installing programs that will be installed by other packages.
           </para>
         </listitem>
       </varlistentry>
@@ -181,7 +181,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
       <varlistentry id="lbracket">
         <term><command>[</command></term>
         <listitem>
-          <para>Is an actual command, /usr/bin/[, that is a synonym
+          <para>Is an actual command, /usr/bin/[; it is a synonym
           for the <command>test</command> command</para>
           <indexterm zone="ch-system-coreutils lbracket">
             <primary sortas="b-111">[</primary>
@@ -275,7 +275,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
         <term><command>chmod</command></term>
         <listitem>
           <para>Changes the permissions of each file to the given mode; the mode
-          can be either a symbolic representation of the changes to make or an
+          can be either a symbolic representation of the changes to be made, or an
           octal number representing the new permissions</para>
           <indexterm zone="ch-system-coreutils chmod">
             <primary sortas="b-chmod">chmod</primary>
@@ -341,7 +341,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
         <term><command>csplit</command></term>
         <listitem>
           <para>Splits a given file into several new files, separating them
-          according to given patterns or line numbers and outputting the byte
+          according to given patterns or line numbers, and outputting the byte
           count of each new file</para>
           <indexterm zone="ch-system-coreutils csplit">
             <primary sortas="b-csplit">csplit</primary>
@@ -363,8 +363,8 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
       <varlistentry id="date">
         <term><command>date</command></term>
         <listitem>
-          <para>Displays the current time in the given format, or sets the
+          <para>Displays the current dae and time in the given format, or sets the
-          system date</para>
+          system date and time</para>
           <indexterm zone="ch-system-coreutils date">
             <primary sortas="b-date">date</primary>
           </indexterm>
@@ -420,7 +420,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
       <varlistentry id="dirname">
         <term><command>dirname</command></term>
         <listitem>
-          <para>Strips the non-directory suffix from a file name</para>
+          <para>Extracts the directory portion(s) of the given name(s)</para>
           <indexterm zone="ch-system-coreutils dirname">
             <primary sortas="b-dirname">dirname</primary>
           </indexterm>
@@ -482,7 +482,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
       <varlistentry id="factor">
         <term><command>factor</command></term>
         <listitem>
-          <para>Prints the prime factors of all specified integer numbers</para>
+          <para>Prints the prime factors of the specified integers</para>
           <indexterm zone="ch-system-coreutils factor">
             <primary sortas="b-factor">factor</primary>
           </indexterm>
@@ -587,7 +587,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
       <varlistentry id="link">
         <term><command>link</command></term>
         <listitem>
-          <para>Creates a hard link with the given name to a file</para>
+          <para>Creates a hard link (with the given name) to a file</para>
           <indexterm zone="ch-system-coreutils link">
             <primary sortas="b-link">link</primary>
           </indexterm>
@@ -647,8 +647,8 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
       <varlistentry id="mkfifo">
         <term><command>mkfifo</command></term>
         <listitem>
-          <para>Creates First-In, First-Outs (FIFOs), a "named
+          <para>Creates First-In, First-Outs (FIFOs), "named
-          pipe" in UNIX parlance, with the given names</para>
+          pipes" in UNIX parlance, with the given names</para>
           <indexterm zone="ch-system-coreutils mkfifo">
             <primary sortas="b-mkfifo">mkfifo</primary>
           </indexterm>
@@ -1230,7 +1230,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
         <term><command>wc</command></term>
         <listitem>
           <para>Reports the number of lines, words, and bytes for each given
-          file, as well as a total line when more than one file is given</para>
+          file, as well as grand totals when more than one file is given</para>
           <indexterm zone="ch-system-coreutils wc">
             <primary sortas="b-wc">wc</primary>
           </indexterm>
@@ -1261,7 +1261,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8</userinput></screen>
       <varlistentry id="yes">
         <term><command>yes</command></term>
         <listitem>
-          <para>Repeatedly outputs <quote>y</quote> or a given string until
+          <para>Repeatedly outputs <quote>y</quote>, or a given string, until
           killed</para>
           <indexterm zone="ch-system-coreutils yes">
             <primary sortas="b-yes">yes</primary>

chapter08/libffi.xml

@@ -53,7 +53,8 @@
       value of the <parameter>--with-gcc-arch=</parameter> parameter in the
       following command to an architecture name fully implemented by the
       CPU on that system.
-      If this is not done, all applications that link to libffi will trigger
+      If this is not done, all applications that link to
+      <filename class='libraryfile'>libffi</filename> will trigger
       Illegal Operation Errors.</para>
     </note>
 

chapter08/meson.xml

@@ -23,7 +23,7 @@
   <sect2 role="package">
     <title/>
 
-    <para>Meson is an open source build system meant to be both extremely fast
+    <para>Meson is an open source build system designed to be both extremely fast
     and as user friendly as possible.</para>
 
     <segmentedlist>
@@ -36,9 +36,10 @@
     </segmentedlist>
 
     <tip revision="sysv">
-      <para>This section is not strictly required for LFS if not using
+      <para>This section is not strictly required when LFS does not use
-      systemd. On the other hand, meson/ninja is a powerful build system,
+      systemd. On the other hand, Meson, along with Ninja, makes
-      which is expected to be used more and more often. It is required for
+      a powerful build system combination,
+      which will probably be used more and more often. It is required for
       several packages in <ulink url="&blfs-book;">the BLFS
       book</ulink>.</para>
     </tip>
@@ -56,7 +57,7 @@
 
 <screen><userinput remap="make">pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
 
-    <para>The test suite requires some packages out of the scope of LFS.</para>
+    <para>The test suite requires some packages outside the scope of LFS.</para>
 
     <para>Install the package:</para>
 
@@ -70,7 +71,7 @@ install -vDm644 data/shell-completions/zsh/_meson /usr/share/zsh/site-functions/
       <varlistentry>
         <term><parameter>-w dist</parameter></term>
         <listitem>
-           <para>Put the created wheels into the
+           <para>Puts the created wheels into the
            <filename class='directory'>dist</filename> directory.</para>
         </listitem>
       </varlistentry>
@@ -78,7 +79,7 @@ install -vDm644 data/shell-completions/zsh/_meson /usr/share/zsh/site-functions/
       <varlistentry>
         <term><parameter>--find-links dist</parameter></term>
         <listitem>
-           <para>Install wheels from the
+           <para>Installs wheels from the
            <filename class='directory'>dist</filename> directory.</para>
         </listitem>
       </varlistentry>

chapter08/perl.xml

@@ -123,9 +123,10 @@ export BUILD_BZIP2=0</userinput></screen>
         <listitem>
           <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
+          based on the MAJOR.MINOR version of Perl (&perl-version-min;) which
-          allows upgrading Perl to newer Patch levels (&perl-version;) without
+          allows upgrading Perl to newer patch levels (the patch level is
-          reinstalling all of the modules.</para>
+          the last dot separated part in the full version string like
+          &perl-version;) without reinstalling all of the modules.</para>
         </listitem>
       </varlistentry>