Merge remote-tracking branch 'origin/trunk' into xry111/clfs-ng

chapter01/changelog.xml

@@ -39,7 +39,41 @@
     <listitem revision="sysv"> or <listitem revision="systemd"> as
     appropriate for the entry or if needed the entire day's listitem.
     -->
-    <listitem revision="systemd">
+    <listitem>
+      <para>2022-11-22</para>
+      <itemizedlist>
+        <listitem>
+          <para>[xry111] - Update to linux-6.0.9. Fixes
+          <ulink url="&lfs-ticket-root;5162">#5162</ulink>.</para>
+        </listitem>
+        <listitem>
+          <para>[xry111] - Update to libpipeline-1.5.7. Fixes
+          <ulink url="&lfs-ticket-root;5163">#5163</ulink>.</para>
+        </listitem>
+        <listitem>
+          <para>[xry111] - Update to xz-5.2.8. Fixes
+          <ulink url="&lfs-ticket-root;5164">#5164</ulink>.</para>
+        </listitem>
+        <listitem>
+          <para>[xry111] - Update to man-db-2.11.1. Fixes
+          <ulink url="&lfs-ticket-root;5166">#5166</ulink>.</para>
+        </listitem>
+        <listitem>
+          <para>[xry111] - Update to mpfr-4.1.1. Fixes
+          <ulink url="&lfs-ticket-root;5167">#5167</ulink>.</para>
+        </listitem>
+        <listitem>
+          <para>[xry111] - Stop disabling decimal float for temporary GCC,
+          so mpfr will be built with decimal float support.</para>
+        </listitem>
+        <listitem>
+          <para>[xry111] - Update instruction for wheel to avoid relying on
+          deprecated Python features.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>2022-11-10</para>
       <itemizedlist>
         <listitem>

chapter05/gcc-pass1.xml

@@ -90,7 +90,6 @@ cd       build</userinput></screen>
     --disable-nls             \
     --disable-shared          \
     --disable-multilib        \
-    --disable-decimal-float   \
     --disable-threads         \
     --disable-libatomic       \
     --disable-libgomp         \

chapter06/gcc-pass2.xml

@@ -92,7 +92,6 @@ cd       build</userinput></screen>
     --enable-default-ssp                           \
     --disable-nls                                  \
     --disable-multilib                             \
-    --disable-decimal-float                        \
     --disable-libatomic                            \
     --disable-libgomp                              \
     --disable-libquadmath                          \

chapter08/acl.xml

@@ -24,7 +24,7 @@
     <title/>
 
     <para>The Acl package contains utilities to administer Access Control Lists,
-    which are used to define more fine-grained discretionary access rights for
+    which are used to define fine-grained discretionary access rights for
     files and directories.</para>
 
     <segmentedlist>
@@ -52,11 +52,11 @@
 
 <screen><userinput remap="make">make</userinput></screen>
 
-    <para>The Acl tests need to be run on a filesystem that supports access
+    <para>The Acl tests must be run on a filesystem that supports access
-    controls after <application>Coreutils</application> has been built with the
+    controls, but not until the <application>Coreutils</application> package has been built,
-    Acl libraries.  If desired, return to this package and run <command>make
+    using the <application>Acl</application> libraries.  If desired, return to this package
-    check</command> after <application>Coreutils</application> has been built
+    and run <command>make check</command> after the <application>Coreutils</application>
-    later in this chapter.</para>
+    package has been built.</para>
 
     <para>Install the package:</para>
 

chapter08/attr.xml

@@ -23,8 +23,8 @@
   <sect2 role="package">
     <title/>
 
-    <para>The attr package contains utilities to administer the extended
+    <para>The Attr package contains utilities to administer the extended
-    attributes on filesystem objects.</para>
+    attributes of filesystem objects.</para>
 
     <segmentedlist>
       <segtitle>&buildtime;</segtitle>
@@ -52,7 +52,7 @@
 
 <screen><userinput remap="make">make</userinput></screen>
 
-    <para>The tests need to be run on a filesystem that supports extended
+    <para>The tests must be run on a filesystem that supports extended
     attributes such as the ext2, ext3, or ext4 filesystems.
     To test the results, issue:</para>
 

chapter08/coreutils.xml

@@ -133,11 +133,10 @@ FORCE_UNSAFE_CONFIGURE=1 ./configure \
 
 <screen><userinput remap="test">su tester -c "PATH=$PATH make RUN_EXPENSIVE_TESTS=yes check"</userinput></screen>
 
-<!-- test-getlogin is now skipped
+<!-- Sometimes skipped, but if not it may fail.
-    <para>The test-getlogin test is known to fail in the LFS chroot environment.</para>
+     Please DO NOT remove or comment out this unless we can fully
--->
+     understand it!  -->
-<!-- should be fixed at next release, coreutils-9.2 -->
+    <para>The test-getlogin test may fail in the LFS chroot environment.</para>
-    <para>The sort-NaN-infloop test is known to fail with GCC-12.</para>
 
     <para>Remove the temporary group:</para>
 

chapter08/libcap.xml

@@ -23,9 +23,9 @@
   <sect2 role="package">
     <title/>
 
-    <para>The Libcap package implements the user-space interfaces to the POSIX
+    <para>The Libcap package implements the user-space interface to the POSIX
-    1003.1e capabilities available in Linux kernels. These capabilities are a
+    1003.1e capabilities available in Linux kernels. These capabilities
-    partitioning of the all powerful root privilege into a set of distinct
+    partition the all-powerful root privilege into a set of distinct
     privileges.</para>
 
     <segmentedlist>
@@ -116,7 +116,7 @@
       <varlistentry id="getpcaps">
         <term><command>getpcaps</command></term>
         <listitem>
-          <para>Displays the capabilities on the queried process(es)</para>
+          <para>Displays the capabilities of the queried process(es)</para>
           <indexterm zone="ch-system-libcap getpcaps">
             <primary sortas="b-getpcaps">getpcaps</primary>
           </indexterm>

chapter08/mpfr.xml

@@ -58,7 +58,7 @@ make html</userinput></screen>
       Do not skip it under any circumstances.</para>
     </important>
 
-    <para>Test the results and ensure that all tests passed:</para>
+    <para>Test the results and ensure that all 183 tests passed:</para>
 
 <screen><userinput remap="test">make check</userinput></screen>
 

chapter08/shadow.xml

@@ -66,16 +66,16 @@ find man -name Makefile.in -exec sed -i 's/passwd\.5 / /'   {} \;</userinput></s
     the obsolete <filename class="directory">/var/spool/mail</filename> location
     for user mailboxes that Shadow uses by default to the <filename
     class="directory">/var/mail</filename> location used currently. And,
-    get rid of <filename class="directory">/bin</filename> and
+    remove <filename class="directory">/bin</filename> and
-    <filename class="directory">/sbin</filename> from <envar>PATH</envar>,
+    <filename class="directory">/sbin</filename> from the <envar>PATH</envar>,
-    since they are simply symlinks to their counterpart in
+    since they are simply symlinks to their counterparts in
     <filename class="directory">/usr</filename>.</para>
 
     <note>
-      <para>If <filename class="directory">/bin</filename> and/or
+      <para>If you wish to include <filename class="directory">/bin</filename>
-      <filename class="directory">/sbin</filename> are preferred to be
+      and/or <filename class="directory">/sbin</filename> in the <envar>PATH</envar>
-      left over in <envar>PATH</envar> for some reason, modify
+      for some reason, modify the
-      <envar>PATH</envar> in <filename>.bashrc</filename> after LFS is
+      <envar>PATH</envar> in <filename>.bashrc</filename> after LFS has been
       built.</para>
     </note>
 
@@ -85,7 +85,7 @@ find man -name Makefile.in -exec sed -i 's/passwd\.5 / /'   {} \;</userinput></s
     -i etc/login.defs</userinput></screen>
 
     <note>
-      <para>If you chose to build Shadow with Cracklib support, run the following:</para>
+      <para>If you chose to build Shadow with Cracklib support, issue this command:</para>
 
 <screen role="nodump"><userinput>sed -i 's:DICTPATH.*:DICTPATH\t/lib/cracklib/pw_dict:' etc/login.defs</userinput></screen>
     </note>
@@ -108,21 +108,22 @@ find man -name Makefile.in -exec sed -i 's/passwd\.5 / /'   {} \;</userinput></s
             --with-group-name-max-length=32</userinput></screen>
 
     <variablelist>
-      <title>The meaning of the configure option:</title>
+      <title>The meaning of the new configuration options:</title>
 
       <varlistentry>
         <term><command>touch /usr/bin/passwd</command></term>
         <listitem>
           <para>The file <filename>/usr/bin/passwd</filename> needs
-          to exist because its location is hardcoded in some programs, and
+          to exist because its location is hardcoded in some programs; 
-          if it does not exist, the default location is not right.</para>
+          if it does not already exist, the installation script will 
+          create it in the wrong place.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term><parameter>--with-group-name-max-length=32</parameter></term>
         <listitem>
-          <para>The maximum user name is 32 characters.  Make the maximum
+          <para>The longest permissible user name is 32 characters.  Make the maximum
-          group name the same.</para>
+          length of a group name the same.</para>
         </listitem>
       </varlistentry>
 
@@ -153,9 +154,9 @@ make -C man install-man</userinput></screen>
     groups; set and change their passwords; and perform other administrative
     tasks. For a full explanation of what <emphasis>password shadowing</emphasis>
     means, see the <filename>doc/HOWTO</filename> file within the unpacked
-    source tree. If using Shadow support, keep in mind that programs which need
+    source tree. If you use Shadow support, keep in mind that programs which need
     to verify passwords (display managers, FTP programs, pop3 daemons, etc.)
-    must be Shadow-compliant. That is, they need to be able to work with
+    must be Shadow-compliant. That is, they must be able to work with
     shadowed passwords.</para>
 
     <para>To enable shadowed passwords, run the following command:</para>
@@ -167,44 +168,44 @@ make -C man install-man</userinput></screen>
 <screen><userinput>grpconv</userinput></screen>
 
     <para>Shadow's default configuration for the <command>useradd</command>
-    utility has a few caveats that need some explanation. First, the default
+    utility needs some explanation. First, the default
     action for the <command>useradd</command> utility is to create the user and
-    a group of the same name as the user. By default the user ID (UID) and
+    a group with the same name as the user. By default the user ID (UID) and
-    group ID (GID) numbers will begin with 1000. This means if you don't pass
+    group ID (GID) numbers will begin at 1000. This means if you don't pass
-    parameters to <command>useradd</command>, each user will be a member of a
+    extra parameters to <command>useradd</command>, each user will be a member of a
     unique group on the system. If this behavior is undesirable, you'll need
-    to pass one of the <parameter>-g</parameter> or <parameter>-N</parameter>
+    to pass either the <parameter>-g</parameter> or <parameter>-N</parameter>
-    parameter to <command>useradd</command> or to change the setting of
+    parameter to <command>useradd</command>, or else change the setting of
     <parameter>USERGROUPS_ENAB</parameter> in
     <filename>/etc/login.defs</filename>. See <filename>useradd(8)</filename>
     for more information.</para>
 
     <para>Second, to change the default parameters, the file
-    <filename>/etc/default/useradd</filename> needs to be created and tailored
+    <filename>/etc/default/useradd</filename> must be created and tailored
     to suit your particular needs. Create it with:</para>
 
 <screen><userinput>mkdir -p /etc/default
 useradd -D --gid 999</userinput></screen>
 
     <variablelist>
-      <title><filename>/etc/default/useradd</filename> Parameter Explanations</title>
+      <title><filename>/etc/default/useradd</filename> parameter explanations</title>
 
       <varlistentry>
         <term><parameter>GROUP=999</parameter></term>
         <listitem>
           <para>This parameter sets the beginning of the group numbers used in
           the <filename>/etc/group</filename> file. The particular value 999
-          comes from the <parameter>--gid</parameter> parameter above.  You can
+          comes from the <parameter>--gid</parameter> parameter above.  You
-          modify it to anything you desire.
+          may set it to any desired value.
 
           Note that <command>useradd</command> will never reuse a UID or GID.
           If the number identified in this parameter is used, it will use the
           next available number. Note also that if you don't have a group with
-          an ID equal to this number on your system the first time you use
+          an ID equal to this number on your system, then the first time you use
           <command>useradd</command> without the <parameter>-g</parameter>
-          parameter, you will get a message displayed on the terminal that
+          parameter, an error message will be generated&mdash;<computeroutput>useradd:
-          says: <computeroutput>useradd: unknown GID 999</computeroutput>,
+          unknown GID 999</computeroutput>,
-          although the account is correctly created. That is why we have
+          even though the account has been created correctly. That is why we
           created the group <systemitem class="groupname">users</systemitem>
           with this group ID in <xref linkend='ch-tools-createfiles'/>.</para>
 
@@ -214,12 +215,11 @@ useradd -D --gid 999</userinput></screen>
         <term><parameter>CREATE_MAIL_SPOOL=yes</parameter></term>
         <listitem>
           <para>This parameter causes <command>useradd</command> to create a
-          mailbox file for the newly created user. <command>useradd</command>
+          mailbox file for each new user. <command>useradd</command>
-          will make the group ownership of this file to the
+          will assign the group ownership of this file to the
           <systemitem class="groupname">mail</systemitem> group with 0660
-          permissions. If you would prefer that these mailbox files are not
+          permissions. If you would rather not create these files,
-          created by <command>useradd</command>, issue the following
+          issue the following command:</para>
-          command:</para>
 
 <screen><userinput>sed -i '/MAIL/s/yes/no/' /etc/default/useradd</userinput></screen>
         </listitem>
@@ -230,7 +230,7 @@ useradd -D --gid 999</userinput></screen>
   </sect2>
 
   <sect2 role="configuration">
-    <title>Setting the root password</title>
+    <title>Setting the Root Password</title>
 
     <para>Choose a password for user <emphasis>root</emphasis> and set it
     by running:</para>
@@ -329,7 +329,7 @@ useradd -D --gid 999</userinput></screen>
         <term><command>faillog</command></term>
         <listitem>
           <para>Is used to examine the log of login failures, to set a maximum
-          number of failures before an account is blocked, or to reset the
+          number of failures before an account is blocked, and to reset the
           failure count</para>
           <indexterm zone="ch-system-shadow faillog">
             <primary sortas="b-faillog">faillog</primary>
@@ -509,9 +509,8 @@ useradd -D --gid 999</userinput></screen>
       <varlistentry id="nologin">
         <term><command>nologin</command></term>
         <listitem>
-          <para>Displays a message that an account is not available; it is designed
+          <para>Displays a message saying an account is not available; it is designed
-          to be used as the default shell for accounts that have been
+          to be used as the default shell for disabled accounts</para>
-          disabled</para>
           <indexterm zone="ch-system-shadow nologin">
             <primary sortas="b-nologin">nologin</primary>
           </indexterm>
@@ -597,7 +596,7 @@ useradd -D --gid 999</userinput></screen>
       <varlistentry id="userdel">
         <term><command>userdel</command></term>
         <listitem>
-          <para>Deletes the given user account</para>
+          <para>Deletes the specified user account</para>
           <indexterm zone="ch-system-shadow userdel">
             <primary sortas="b-userdel">userdel</primary>
           </indexterm>
@@ -607,8 +606,8 @@ useradd -D --gid 999</userinput></screen>
       <varlistentry id="usermod">
         <term><command>usermod</command></term>
         <listitem>
-          <para>Is used to modify the given user's login name, User
+          <para>Is used to modify the given user's login name, user
-          Identification (UID), shell, initial group, home directory, etc.</para>
+          identification (UID), shell, initial group, home directory, etc.</para>
           <indexterm zone="ch-system-shadow usermod">
             <primary sortas="b-usermod">usermod</primary>
           </indexterm>
@@ -640,7 +639,7 @@ useradd -D --gid 999</userinput></screen>
       <varlistentry id="libsubid">
         <term><filename class='libraryfile'>libsubid</filename></term>
         <listitem>
-          <para>library for process subordinate id ranges for users</para>
+          <para>library for processing subordinate id ranges for users</para>
           <indexterm zone="ch-system-shadow libsubid">
             <primary sortas="c-libsubid">libsubid</primary>
           </indexterm>

chapter08/wheel.xml

@@ -40,12 +40,39 @@
   <sect2 role="installation">
     <title>Installation of Wheel</title>
 
+    <para>Compile wheel with the following command:</para>
+
+<screen><userinput remap="make">PYTHONPATH=src pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
+
     <para>Install wheel with the following command:</para>
 
-<screen><userinput remap="install">pip3 install --no-index $PWD</userinput></screen>
+<screen><userinput remap="install">pip3 install --no-index --find-links=dist wheel</userinput></screen>
 
     <variablelist>
-      <title>The meaning of the pip3 options:</title>
+      <title>The meaning of the pip3 commands:</title>
+
+      <varlistentry>
+        <term><envar>PYTHONPATH=src</envar></term>
+        <listitem>
+           <para>Allow using this package (not installed yet) to build a
+           wheel archive for itself, to avoid a chicken-or-egg problem.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><command>wheel</command></term>
+        <listitem>
+           <para>Build wheel archive for this package.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>-w dist</parameter></term>
+        <listitem>
+           <para>Put the created wheels into the
+           <filename class='directory'>dist</filename> directory.</para>
+        </listitem>
+      </varlistentry>
 
       <varlistentry>
         <term><command>install</command></term>
@@ -55,24 +82,25 @@
       </varlistentry>
 
       <varlistentry>
-        <term><parameter>--no-index</parameter></term>
+        <term><parameter>--no-build-isolation</parameter>,
+              <parameter>--no-deps</parameter>, and
+              <parameter>--no-index</parameter></term>
         <listitem>
           <para>Prevent pip from fetching files from the online package
           repository (PyPI). If packages are installed in the correct order,
-          then it won't need to fetch any files in the first place, but this
+          then it won't need to fetch any files in the first place, but these
-          option adds some safety in case of user error.</para>
+          options add some safety in case of user error.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
-        <term><parameter>$PWD</parameter></term>
+        <term><parameter>--find-links dist</parameter></term>
         <listitem>
-           <para>Look for files to install in the current working directory.</para>
+           <para>Search wheel archives from the
+           <filename class='directory'>dist</filename> directory.</para>
         </listitem>
       </varlistentry>
-
     </variablelist>
-
   </sect2>
 
   <sect2 id="contents-wheel" role="content">
@@ -86,7 +114,7 @@
         <seg>wheel</seg>
         <seg>
            /usr/lib/python&python-minor;/site-packages/wheel and
-           /usr/lib/python&python-minor;/site-packages/wheel-0.37.1-py3.10.egg-info
+           /usr/lib/python&python-minor;/site-packages/wheel-&wheel-version;.dist-info
         </seg>
       </seglistitem>
     </segmentedlist>

packages.ent

@@ -410,10 +410,10 @@
 <!ENTITY libffi-fin-du "10 MB">
 <!ENTITY libffi-fin-sbu "1.8 SBU">
 
-<!ENTITY libpipeline-version "1.5.6">
+<!ENTITY libpipeline-version "1.5.7">
-<!ENTITY libpipeline-size "954 KB">
+<!ENTITY libpipeline-size "956 KB">
 <!ENTITY libpipeline-url "&savannah;/releases/libpipeline/libpipeline-&libpipeline-version;.tar.gz">
-<!ENTITY libpipeline-md5 "829c9ba46382b0b3e12dd11fcbc1bb27">
+<!ENTITY libpipeline-md5 "1a48b5771b9f6c790fb4efdb1ac71342">
 <!ENTITY libpipeline-home "https://libpipeline.nongnu.org/">
 <!ENTITY libpipeline-fin-du "10 MB">
 <!ENTITY libpipeline-fin-sbu "0.1 SBU">
@@ -428,12 +428,12 @@
 
 <!ENTITY linux-major-version "6">
 <!ENTITY linux-minor-version "0">
-<!ENTITY linux-patch-version "7">
+<!ENTITY linux-patch-version "9">
 <!--<!ENTITY linux-version "&linux-major-version;.&linux-minor-version;">-->
 <!ENTITY linux-version "&linux-major-version;.&linux-minor-version;.&linux-patch-version;">
-<!ENTITY linux-size "130,748 KB">
+<!ENTITY linux-size "130,776 KB">
 <!ENTITY linux-url "&kernel;linux/kernel/v&linux-major-version;.x/linux-&linux-version;.tar.xz">
-<!ENTITY linux-md5 "690e3de421b693bf111ec74a97476ea7">
+<!ENTITY linux-md5 "3de364bdbacd2115950cc3dd94157ab6">
 <!ENTITY linux-home "https://www.kernel.org/">
 <!-- measured for 5.13.4 / gcc-11.1.0 on x86_64 : minimum is
  allnoconfig rounded down to allow for ongoing cleanups,
@@ -469,10 +469,10 @@
 <!ENTITY make-fin-du "14 MB">
 <!ENTITY make-fin-sbu "0.5 SBU">
 
-<!ENTITY man-db-version "2.11.0">
+<!ENTITY man-db-version "2.11.1">
-<!ENTITY man-db-size "1,879 KB">
+<!ENTITY man-db-size "1,904 KB">
 <!ENTITY man-db-url "&savannah;/releases/man-db/man-db-&man-db-version;.tar.xz">
-<!ENTITY man-db-md5 "ad12e19d4f86d866a3858decf6989746">
+<!ENTITY man-db-md5 "88caf8efe127453f9dcb2ff9b2983f59">
 <!ENTITY man-db-home "https://www.nongnu.org/man-db/">
 <!ENTITY man-db-fin-du "40 MB">
 <!ENTITY man-db-fin-sbu "0.4 SBU">
@@ -509,10 +509,10 @@
 <!ENTITY mpc-fin-du "21 MB">
 <!ENTITY mpc-fin-sbu "0.3 SBU">
 
-<!ENTITY mpfr-version "4.1.0">
+<!ENTITY mpfr-version "4.1.1">
-<!ENTITY mpfr-size "1,490 KB">
+<!ENTITY mpfr-size "1,400 KB">
 <!ENTITY mpfr-url "https://ftp.gnu.org/gnu/mpfr/mpfr-&mpfr-version;.tar.xz">
-<!ENTITY mpfr-md5 "bdd3d5efba9c17da8d83a35ec552baef">
+<!ENTITY mpfr-md5 "d182b62e811f744d149b14540d8e922b">
 <!ENTITY mpfr-home "https://www.mpfr.org/">
 <!ENTITY mpfr-fin-du "39 MB">
 <!ENTITY mpfr-fin-sbu "0.8 SBU">
@@ -753,10 +753,10 @@
 <!ENTITY xml-parser-fin-du "2.3 MB">
 <!ENTITY xml-parser-fin-sbu "less than 0.1 SBU">
 
-<!ENTITY xz-version "5.2.7">
+<!ENTITY xz-version "5.2.8">
-<!ENTITY xz-size "1,253 KB">
+<!ENTITY xz-size "1,260 KB">
 <!ENTITY xz-url "https://tukaani.org/xz/xz-&xz-version;.tar.xz">
-<!ENTITY xz-md5 "6c130d21e260d4476e971985e7394e83">
+<!ENTITY xz-md5 "7cfa6136d984083e7d4da12c8fb083ea">
 <!ENTITY xz-home "https://tukaani.org/xz">
 <!ENTITY xz-tmp-du "16 MB">
 <!ENTITY xz-tmp-sbu "0.1 SBU">