Changeset ed7a3952 for chapter08

Timestamp:

12/18/2022 04:20:46 PM (19 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

xry111/arm64, xry111/arm64-12.0

Children:

688a8f5

Parents:

d270248 (diff), c8e374b (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:

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

Location:

chapter08

Files:

• bash.xml (modified) (1 diff)
• binutils.xml (modified) (1 diff)
• gawk.xml (modified) (2 diffs)
• glibc.xml (modified) (1 diff)
• iproute2.xml (modified) (2 diffs)
• kbd.xml (modified) (1 diff)
• man-db.xml (modified) (1 diff)
• mpc.xml (modified) (1 diff)
• procps.xml (modified) (4 diffs)
• vim.xml (modified) (7 diffs)

chapter08/bash.xml

@@ -43 +43 @@
     <para>Prepare Bash for compilation:</para>
 
-<screen><userinput remap="configure">./configure --prefix=/usr                      \
-            --docdir=/usr/share/doc/bash-&bash-version; \
-            --without-bash-malloc              \
-            --with-installed-readline</userinput></screen>
+    <screen><userinput remap="configure">./configure --prefix=/usr             \
+            --without-bash-malloc     \
+            --with-installed-readline \
+            --docdir=/usr/share/doc/bash-&bash-version;</userinput></screen>
 
     <variablelist>

chapter08/binutils.xml

@@ -174 +174 @@
     known to fail.
     <!-- https://sourceware.org/bugzilla/show_bug.cgi?id=29107 -->
-    Because of a race between the gas testsuite and the gprofng testsuite,
+    Because of a race between the gas test suite and the gprofng test suite,
     some gas tests may fail if parallel jobs are used.  If you are not
     assured of the correctness of gas, invoke
-    <command>make check-gas</command> to run gas testsuite separately and
+    <command>make check-gas</command> to run the gas test suite separately and
     all tests should pass. Three gprofng tests yield the 
     <literal>ERROR</literal> result, and they are counted as

chapter08/gawk.xml

@@ -59 +59 @@
     <para>Install the package:</para>
 
-<screen><userinput remap="install">make install</userinput></screen>
+<screen><userinput remap="install">make LN='ln -f' install</userinput></screen>
+
+    <variablelist>
+      <title>The meaning of the overridden make variable:</title>
+
+      <varlistentry>
+        <term><envar>LN='ln -f'</envar></term>
+        <listitem>
+           <para>This variable ensures that the previous hard link installed
+           in <xref linkend='ch-tools-gawk'/> is updated here.</para>
+       </listitem>
+      </varlistentry>
+   </variablelist>
 
     <para>If desired, install the documentation:</para>
@@ -77 +89 @@
 
       <seglistitem>
-        <seg>awk (link to gawk), gawk, and awk-&gawk-version;</seg>
+        <seg>awk (link to gawk), gawk, and gawk-&gawk-version;</seg>
         <seg>filefuncs.so, fnmatch.so, fork.so, inplace.so, intdiv.so, ordchr.so,
         readdir.so, readfile.so, revoutput.so, revtwoway.so, rwarray.so,

chapter08/glibc.xml

@@ -388 +388 @@
           necessary to put the POSIX time zones in
           <filename class="directory">zoneinfo</filename>, otherwise various
-          test-suites will report errors. On an embedded system, where space is
+          test suites will report errors. On an embedded system, where space is
           tight and you do not intend to ever update the time zones, you could save
           1.9 MB by not using the <filename class="directory">posix</filename>
-          directory, but some applications or test-suites might produce some
+          directory, but some applications or test suites might produce some
           failures.</para>
         </listitem>

chapter08/iproute2.xml

@@ -272 +272 @@
       </varlistentry>
 
-      <!-- FixMe These options don't match tc -help screen -->
       <varlistentry id="tc">
         <term><command>tc</command></term>
@@ -285 +284 @@
           on the queuing discipline scheduling</para>
 
-          <para><command>tc estimator</command> allows users to estimate the
-          data flow through a network</para>
-
           <para><command>tc filter</command> allows users to set up the QoS/CoS
           packet filtering</para>
-
-          <para><command>tc policy</command> allows users to set up the QoS/CoS
-          policies</para>
+        
+          <para><command>tc monitor</command> can be used to view changes
+          made to Traffic Control in the kernel.</para>
+          
           <indexterm zone="ch-system-iproute2 ss">
             <primary sortas="b-tc">tc</primary>

chapter08/kbd.xml

@@ -42 +42 @@
     <title>Installation of Kbd</title>
 
-    <para>The behaviour of the backspace and delete keys is not consistent
+    <para>The behavior of the backspace and delete keys is not consistent
     across the keymaps in the Kbd package. The following patch fixes this
     issue for i386 keymaps:</para>

chapter08/man-db.xml

@@ -78 +78 @@
         <term><parameter>--enable-cache-owner=bin</parameter></term>
         <listitem>
-          <para>This makes the system-wide cache files be owned by user
+          <para>This changes ownership of the system-wide cache files to user
           <systemitem class="username">bin</systemitem>.</para>
         </listitem>

chapter08/mpc.xml

@@ -42 +42 @@
   <sect2 role="installation">
     <title>Installation of MPC</title>
+
+    <para>First, make a fix identified upstream:</para>
+
+<screen><userinput remap="pre">sed -i '273{ h; d; }; 274,286 { H; d; }; 287 G' src/mpc.h</userinput></screen>
+
+    <note> 
+       <para>This sed is a little complex and needs some explanation.  It holds
+       the line 273 in a buffer, adds lines 274-286 to it. It then writes the
+       buffer out after line 287 is read. The result is that the line 287 is
+       moved upwards from an incorrect location to its correct location in an
+       #ifdef block.</para>
+    </note>
 
     <para>Prepare MPC for compilation:</para>

chapter08/procps.xml

@@ -41 +41 @@
     <title>Installation of Procps-ng</title>
 
-    <para>Prepare procps-ng for compilation:</para>
+    <para>Prepare Procps-ng for compilation:</para>
 
 <screen revision="sysv"><userinput remap="configure">./configure --prefix=/usr                           \
@@ -61 +61 @@
         <listitem>
           <para>This switch disables building the <command>kill</command>
-          command that will be installed by the Util-linux package.</para>
+          command; it will be installed from the Util-linux package.</para>
         </listitem>
       </varlistentry>
@@ -182 +182 @@
       </varlistentry>
 
-      <varlistentry id="pwait">
+      <!-- <varlistentry id="pwait">
         <term><command>pwait</command></term>
         <listitem>
@@ -190 +190 @@
           </indexterm>
         </listitem>
-      </varlistentry>
+      </varlistentry> This program no longer exists; 
+      it's already been removed from the Installed programs list. -->
 
       <varlistentry id="pwdx">

chapter08/vim.xml

@@ -55 +55 @@
 <screen><userinput remap="pre">echo '#define SYS_VIMRC_FILE "/etc/vimrc"' &gt;&gt; src/feature.h</userinput></screen>
 
-    <para>Prepare vim for compilation:</para>
+    <para>Prepare Vim for compilation:</para>
 
 <screen><userinput remap="configure">./configure --prefix=/usr</userinput></screen>
@@ -84 +84 @@
 <screen><userinput remap="install">make install</userinput></screen>
 
-    <para>Many users are used to using <command>vi</command> instead of
+    <para>Many users reflexively type <command>vi</command> instead of
     <command>vim</command>. To allow execution of <command>vim</command>
     when users habitually enter <command>vi</command>, create a
@@ -95 +95 @@
 done</userinput></screen>
 
-    <para>By default, vim's documentation is installed in <filename
+    <para>By default, Vim's documentation is installed in <filename
     class="directory">/usr/share/vim</filename>. The following symlink
     allows the documentation to be accessed via <filename
@@ -104 +104 @@
 
     <para>If an X Window System is going to be installed on the LFS
-    system, it may be necessary to recompile vim after installing X. Vim
+    system, it may be necessary to recompile Vim after installing X. Vim
     comes with a GUI version of the editor that requires X and some
     additional libraries to be installed. For more information on this
-    process, refer to the vim documentation and the vim installation page
+    process, refer to the Vim documentation and the Vim installation page
     in the BLFS book at <ulink
     url="&blfs-book;postlfs/vim.html"/>.</para>
@@ -167 +167 @@
 
     <note>
-      <para>By default, vim only installs spell files for the English language.
-      To install spell files for your preferred language, copy the
+      <para>By default, vim only installs spell-checking files for the English language.
+      To install spell-checking files for your preferred language, copy the
       <filename class='extension'>.spl</filename> and optionally, the
       <filename class='extension'>.sug</filename> files for your language
@@ -176 +176 @@
         /usr/share/&vim-docdir;/spell/</filename>.</para>
 
-      <para>To use these spell files, some configuration in
+      <para>To use these spell-checking files, some configuration in
       <filename>/etc/vimrc</filename> is needed, e.g.:</para>
 
@@ -298 +298 @@
         <listitem>
           <para>Creates a hex dump of the given file; it can
-          also do the reverse, so it can be used for binary patching</para>
+          also perform the inverse operation, so it can be used for binary
+          patching</para>
           <indexterm zone="ch-system-vim xxd">
             <primary sortas="b-xxd">xxd</primary>