diff options
Diffstat (limited to 'chapter08')
38 files changed, 137 insertions, 138 deletions
diff --git a/chapter08/attr.xml b/chapter08/attr.xml index 122781f27..a7a9bb426 100644 --- a/chapter08/attr.xml +++ b/chapter08/attr.xml @@ -53,7 +53,7 @@ <screen><userinput remap="make">make</userinput></screen> <para>The tests need to be run on a filesystem that supports extended - attributes such as the ext2, ext3, or ext4 filesystems. + attributes such as the ext2, ext3, or ext4 filesystems. To test the results, issue:</para> <screen><userinput remap="test">make check</userinput></screen> diff --git a/chapter08/automake.xml b/chapter08/automake.xml index 0ea77d729..92fae932b 100644 --- a/chapter08/automake.xml +++ b/chapter08/automake.xml @@ -59,7 +59,7 @@ <screen><userinput remap="test">make -j4 check</userinput></screen> <!-- - <para>The tests t/subobj.sh, t/deprecated-acinit.sh, and t/init.sh are known to + <para>The tests t/subobj.sh, t/deprecated-acinit.sh, and t/init.sh are known to fail in the LFS environment.</para> --> <para>Install the package:</para> diff --git a/chapter08/bc.xml b/chapter08/bc.xml index 2f29c1859..9678ddd54 100644 --- a/chapter08/bc.xml +++ b/chapter08/bc.xml @@ -23,7 +23,7 @@ <sect2 role="package"> <title/> - <para>The Bc package contains an arbitrary precision numeric processing + <para>The Bc package contains an arbitrary precision numeric processing language.</para> <segmentedlist> diff --git a/chapter08/binutils.xml b/chapter08/binutils.xml index c01ba44bd..113236674 100644 --- a/chapter08/binutils.xml +++ b/chapter08/binutils.xml @@ -74,7 +74,7 @@ find -name \*.1 -delete</userinput></screen> <screen><userinput remap="pre">sed -i '/@\tincremental_copy/d' gold/testsuite/Makefile.in</userinput></screen> --> - <para>The Binutils documentation recommends building Binutils + <para>The Binutils documentation recommends building Binutils in a dedicated build directory:</para> <screen><userinput remap="pre">mkdir -v build @@ -297,7 +297,7 @@ cd build</userinput></screen> <varlistentry id="ld.gold"> <term><command>ld.gold</command></term> <listitem> - <para>A cut down version of ld that only supports the + <para>A cut down version of ld that only supports the elf object file format</para> <indexterm zone="ch-system-binutils ld.gold"> <primary sortas="b-ld.gold">ld.gold</primary> diff --git a/chapter08/chapter08.xml b/chapter08/chapter08.xml index e9cb2b2ce..7b638cc0d 100644 --- a/chapter08/chapter08.xml +++ b/chapter08/chapter08.xml @@ -66,7 +66,7 @@ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ninja.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="meson.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="coreutils.xml"/> - <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="check.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="check.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="diffutils.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gawk.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="findutils.xml"/> diff --git a/chapter08/coreutils.xml b/chapter08/coreutils.xml index cb8ec6d64..f5c4118ad 100644 --- a/chapter08/coreutils.xml +++ b/chapter08/coreutils.xml @@ -88,7 +88,7 @@ FORCE_UNSAFE_CONFIGURE=1 ./configure \ <varlistentry> <term><envar>FORCE_UNSAFE_CONFIGURE=1</envar></term> <listitem> - <para>This environment variable allows the package to be + <para>This environment variable allows the package to be built as the <systemitem class="username">root</systemitem> user. </para> </listitem> diff --git a/chapter08/dbus.xml b/chapter08/dbus.xml index 94d348d2d..271df146f 100644 --- a/chapter08/dbus.xml +++ b/chapter08/dbus.xml @@ -114,7 +114,7 @@ <seglistitem> <seg>dbus-cleanup-sockets, dbus-daemon, dbus-launch, dbus-monitor, - dbus-run-session, dbus-send, dbus-test-tool, + dbus-run-session, dbus-send, dbus-test-tool, dbus-update-activation-environment, and dbus-uuidgen</seg> <seg>libdbus-1.{a,so}</seg> <seg>/etc/dbus-1, /usr/include/dbus-1.0, /usr/lib/dbus-1.0, diff --git a/chapter08/eudev.xml b/chapter08/eudev.xml index aa86f5150..efaba9d30 100644 --- a/chapter08/eudev.xml +++ b/chapter08/eudev.xml @@ -24,7 +24,7 @@ <title/> <para>The Eudev package contains programs for dynamic creation of device - nodes.</para> + nodes.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> @@ -76,7 +76,7 @@ mkdir -pv /etc/udev/rules.d</userinput></screen> <screen><userinput remap="install">make install</userinput></screen> - <para>Install some custom rules and support files useful in an LFS + <para>Install some custom rules and support files useful in an LFS environment:</para> <screen><userinput remap="install">tar -xvf ../&udev-lfs-version;.tar.xz diff --git a/chapter08/expect.xml b/chapter08/expect.xml index 1e56595fb..6503372c6 100644 --- a/chapter08/expect.xml +++ b/chapter08/expect.xml @@ -62,7 +62,7 @@ <varlistentry> <term><parameter>--with-tcl=/usr/lib</parameter></term> <listitem> - <para>This parameter is needed to tell + <para>This parameter is needed to tell <command>configure</command> where the <command>tclConfig.sh</command> script is located.</para> </listitem> diff --git a/chapter08/gcc.xml b/chapter08/gcc.xml index bbe83a50d..fc8748fc3 100644 --- a/chapter08/gcc.xml +++ b/chapter08/gcc.xml @@ -115,7 +115,7 @@ cd build</userinput></screen> <para>Test the results as a non-privileged user, but do not stop at errors:</para> -<screen><userinput remap="test">chown -Rv tester . +<screen><userinput remap="test">chown -Rv tester . su tester -c "PATH=$PATH make -k check"</userinput></screen> <para>To receive a summary of the test suite results, run:</para> @@ -185,7 +185,7 @@ rm -rf /usr/lib/gcc/$(gcc -dumpmachine)/&gcc-version;/include-fixed/bits/</useri <screen><userinput remap="install">ln -sv gcc /usr/bin/cc</userinput></screen> --> <para>Add a compatibility symlink to enable building programs with - Link Time Optimization (LTO):</para> + Link Time Optimization (LTO):</para> <screen><userinput remap="install">ln -sfv ../../libexec/gcc/$(gcc -dumpmachine)/&gcc-version;/liblto_plugin.so \ /usr/lib/bfd-plugins/</userinput></screen> @@ -351,7 +351,7 @@ mv -v /usr/lib/*gdb.py /usr/share/gdb/auto-load/usr/lib</userinput></screen> libstdc++.{a,so}, libstdc++fs.a, libsupc++.a, libtsan.{a,so}, and libubsan.{a,so}</seg> - <seg>/usr/include/c++, /usr/lib/gcc, /usr/libexec/gcc, and + <seg>/usr/include/c++, /usr/lib/gcc, /usr/libexec/gcc, and /usr/share/gcc-&gcc-version;</seg> </seglistitem> </segmentedlist> diff --git a/chapter08/glibc.xml b/chapter08/glibc.xml index 968b398e0..c0e89455c 100644 --- a/chapter08/glibc.xml +++ b/chapter08/glibc.xml @@ -46,7 +46,7 @@ <para>First, fix a security problem identified upstream:</para> <screen><userinput remap="pre">sed -e '/NOTIFY_REMOVED)/s/)/ \&\& data.attr != NULL)/' \ - -i sysdeps/unix/sysv/linux/mq_notify.c</userinput></screen> + -i sysdeps/unix/sysv/linux/mq_notify.c</userinput></screen> <para>Some of the Glibc programs use the non-FHS compliant <filename class="directory">/var/db</filename> directory to store @@ -55,7 +55,7 @@ <screen><userinput remap="pre">patch -Np1 -i ../&glibc-fhs-patch;</userinput></screen> - <para>The Glibc documentation recommends building Glibc + <para>The Glibc documentation recommends building Glibc in a dedicated build directory:</para> <screen><userinput remap="pre">mkdir -v build @@ -82,7 +82,7 @@ cd build</userinput></screen> <varlistentry> <term><parameter>--disable-werror</parameter></term> <listitem> - <para>This option disables the -Werror option passed to + <para>This option disables the -Werror option passed to GCC. This is necessary for running the test suite.</para> </listitem> </varlistentry> @@ -100,7 +100,7 @@ cd build</userinput></screen> <varlistentry> <term><parameter>--enable-stack-protector=strong</parameter></term> <listitem> - <para>This option increases system security by adding + <para>This option increases system security by adding extra code to check for buffer overflows, such as stack smashing attacks.</para> </listitem> @@ -150,18 +150,18 @@ esac</userinput></screen> <para>You may see some test failures. The Glibc test suite is somewhat dependent on the host system. A few failures out of - over 4200 tests can generally be ignored. This is a list of the + over 4200 tests can generally be ignored. This is a list of the most common issues seen for recent versions of LFS:</para> <itemizedlist> <listitem> - <para><emphasis>io/tst-lchmod</emphasis> + <para><emphasis>io/tst-lchmod</emphasis> is known to fail in the LFS chroot environment.</para> </listitem> <listitem> - <para><emphasis>misc/tst-ttyname</emphasis> + <para><emphasis>misc/tst-ttyname</emphasis> is known to fail in the LFS chroot environment.</para> </listitem> <!-- @@ -173,7 +173,7 @@ esac</userinput></screen> <listitem> <para>The <emphasis>rt/tst-cputimer{1,2,3}</emphasis> tests depend on the host system kernel. Kernels 4.14.91–4.14.96, - 4.19.13–4.19.18, and 4.20.0–4.20.5 are known to + 4.19.13–4.19.18, and 4.20.0–4.20.5 are known to cause these tests to fail. </para> </listitem> @@ -213,7 +213,7 @@ esac</userinput></screen> <screen><userinput remap="install">cp -v ../nscd/nscd.conf /etc/nscd.conf mkdir -pv /var/cache/nscd</userinput></screen> - <para revision="systemd">Install the systemd support files for + <para revision="systemd">Install the systemd support files for <command>nscd</command>:</para> <screen revision="systemd"><userinput remap="install">install -v -Dm644 ../nscd/nscd.tmpfiles /usr/lib/tmpfiles.d/nscd.conf @@ -287,13 +287,13 @@ localedef -i zh_TW -f UTF-8 zh_TW.UTF-8</userinput></screen> <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> file when you need them. For instance, the following two locales are needed for some tests later in this chapter:</para> - + <screen role="nodump"><userinput remap="locale-full">localedef -i POSIX -f UTF-8 C.UTF-8 2> /dev/null || true localedef -i ja_JP -f SHIFT_JIS ja_JP.SIJS 2> /dev/null || true</userinput></screen> - <note><para>Glibc now uses libidn2 when resolving internationalized + <note><para>Glibc now uses libidn2 when resolving internationalized domain names. This is a run time dependency. If this capability - is needed, the instructions for installing libidn2 are in the + is needed, the instructions for installing libidn2 are in the <ulink url="&blfs-book;general/libidn2.html">BLFS libidn2 page</ulink>. </para></note> @@ -479,7 +479,7 @@ mkdir -pv /etc/ld.so.conf.d</userinput></screen> <seglistitem> <seg>catchsegv, gencat, getconf, getent, iconv, iconvconfig, ldconfig, - ldd, lddlibc4, locale, localedef, makedb, mtrace, nscd, + ldd, lddlibc4, locale, localedef, makedb, mtrace, nscd, pcprofiledump, pldd, sln, sotruss, sprof, tzselect, xtrace, zdump, and zic</seg> <seg>ld-linux-x86-64.so.2, ld-linux.so.2, @@ -949,7 +949,6 @@ mkdir -pv /etc/ld.so.conf.d</userinput></screen> code for <quote>standard</quote> functions used in many different Unix utilities. These functions are now in <filename class="libraryfile">libc</filename></para> - <indexterm zone="ch-system-glibc libutil"> <primary sortas="c-libutil">libutil</primary> </indexterm> diff --git a/chapter08/gmp.xml b/chapter08/gmp.xml index 2419e2d02..0820f726c 100644 --- a/chapter08/gmp.xml +++ b/chapter08/gmp.xml @@ -53,7 +53,7 @@ <note> <para>The default settings of GMP produce libraries optimized for the host processor. If libraries suitable for processors less - capable than the host's CPU are desired, generic libraries can be + capable than the host's CPU are desired, generic libraries can be created by running the following: <screen role="nodump"><userinput>cp -v configfsf.guess config.guess @@ -100,7 +100,7 @@ make html</userinput></screen> <para>Test the results:</para> <screen><userinput remap="test">make check 2>&1 | tee gmp-check-log</userinput></screen> - + <caution><para>The code in gmp is highly optimized for the processor where it is built. Occasionally, the code that detects the processor misidentifies the system capabilities and there will be errors in the tests or other diff --git a/chapter08/grub.xml b/chapter08/grub.xml index 07be0e851..e9008c31a 100644 --- a/chapter08/grub.xml +++ b/chapter08/grub.xml @@ -106,11 +106,11 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin <seglistitem> <seg>grub-bios-setup, grub-editenv, grub-file, grub-fstest, - grub-glue-efi, grub-install, grub-kbdcomp, grub-macbless, + grub-glue-efi, grub-install, grub-kbdcomp, grub-macbless, grub-menulst2cfg, grub-mkconfig, grub-mkimage, grub-mklayout, grub-mknetdir, grub-mkpasswd-pbkdf2, grub-mkrelpath, grub-mkrescue, grub-mkstandalone, - grub-ofpathname, grub-probe, grub-reboot, grub-render-label, + grub-ofpathname, grub-probe, grub-reboot, grub-render-label, grub-script-check, grub-set-default, grub-sparc64-setup, and grub-syslinux2cfg</seg> diff --git a/chapter08/gzip.xml b/chapter08/gzip.xml index afbfa36a0..a20bcdd7a 100644 --- a/chapter08/gzip.xml +++ b/chapter08/gzip.xml @@ -66,7 +66,7 @@ <segtitle>Installed programs</segtitle> <seglistitem> - <seg>gunzip, gzexe, gzip, uncompress (hard link with gunzip), zcat, zcmp, + <seg>gunzip, gzexe, gzip, uncompress (hard link with gunzip), zcat, zcmp, zdiff, zegrep, zfgrep, zforce, zgrep, zless, zmore, and znew</seg> </seglistitem> </segmentedlist> diff --git a/chapter08/inetutils.xml b/chapter08/inetutils.xml index ad828f67d..8acb361d8 100644 --- a/chapter08/inetutils.xml +++ b/chapter08/inetutils.xml @@ -128,7 +128,7 @@ <segtitle>Installed programs</segtitle> <seglistitem> - <seg>dnsdomainname, ftp, ifconfig, hostname, ping, ping6, + <seg>dnsdomainname, ftp, ifconfig, hostname, ping, ping6, talk, telnet, tftp, and traceroute</seg> </seglistitem> </segmentedlist> diff --git a/chapter08/iproute2.xml b/chapter08/iproute2.xml index 9d6a0c264..e1b2d189e 100644 --- a/chapter08/iproute2.xml +++ b/chapter08/iproute2.xml @@ -43,8 +43,8 @@ <para>The <command>arpd</command> program included in this package will not be built since it is dependent on Berkeley DB, which is not installed in - LFS. However, a directory for <command>arpd</command> and a man page will still - be installed. Prevent this by running the commands below. + LFS. However, a directory for <command>arpd</command> and a man page will still + be installed. Prevent this by running the commands below. If the <command>arpd</command> binary is needed, instructions for compiling Berkeley DB can be found in the BLFS Book at <ulink url="&blfs-book;server/db.html"/>. @@ -53,7 +53,7 @@ <screen><userinput remap="pre">sed -i /ARPD/d Makefile rm -fv man/man8/arpd.8</userinput></screen> - <para>It is also necessary to disable building two modules that + <para>It is also necessary to disable building two modules that require <ulink url="&blfs-book;postlfs/iptables.html"/>.</para> <screen><userinput remap="pre">sed -i 's/.m_ipt.o//' tc/Makefile</userinput></screen> diff --git a/chapter08/kbd.xml b/chapter08/kbd.xml index a219102eb..911720129 100644 --- a/chapter08/kbd.xml +++ b/chapter08/kbd.xml @@ -116,7 +116,7 @@ cp -R -v docs/doc/* /usr/share/doc/kbd-&kbd-version;</userinput></screen> psfxtable), psfstriptable (link to psfxtable), psfxtable, <!--resizecons,--> setfont, setkeycodes, setleds, setmetamode, setvtrgb, showconsolefont, showkey, unicode_start, and unicode_stop</seg> - <seg>/usr/share/consolefonts, /usr/share/consoletrans, /usr/share/keymaps, + <seg>/usr/share/consolefonts, /usr/share/consoletrans, /usr/share/keymaps, /usr/share/doc/kbd-&kbd-version;, and /usr/share/unimaps</seg> </seglistitem> </segmentedlist> diff --git a/chapter08/kmod.xml b/chapter08/kmod.xml index f26c776a9..4288f31d9 100644 --- a/chapter08/kmod.xml +++ b/chapter08/kmod.xml @@ -91,7 +91,7 @@ ln -sfv kmod /usr/bin/lsmod</userinput></screen> <segtitle>Installed library</segtitle> <seglistitem> - <seg>depmod (link to kmod), insmod (link to kmod), kmod, + <seg>depmod (link to kmod), insmod (link to kmod), kmod, lsmod (link to kmod), modinfo (link to kmod), modprobe (link to kmod), and rmmod (link to kmod)</seg> <seg>libkmod.so</seg> diff --git a/chapter08/libelf.xml b/chapter08/libelf.xml index 3465531a1..9434a3996 100644 --- a/chapter08/libelf.xml +++ b/chapter08/libelf.xml @@ -55,7 +55,7 @@ <screen><userinput remap="make">make</userinput></screen> <para>To test the results, issue:</para> - + <screen><userinput remap="test">make check</userinput></screen> <!-- <para>One test, run-elfclassify.sh, is known to fail.</para>--> diff --git a/chapter08/libffi.xml b/chapter08/libffi.xml index 1c93a7df4..11539b2cf 100644 --- a/chapter08/libffi.xml +++ b/chapter08/libffi.xml @@ -66,9 +66,9 @@ <para>Ensure GCC optimizes for the current system. If this is not specified, the system is guessed and the code generated may not be correct for some systems. If the generated code - will be copied from the native system to a less capable - system, use the less capable system as a parameter. For details - about alternative system types, see <ulink + will be copied from the native system to a less capable + system, use the less capable system as a parameter. For details + about alternative system types, see <ulink url='https://gcc.gnu.org/onlinedocs/gcc-&gcc-version;/gcc/x86-Options.html'> the x86 options in the GCC manual</ulink>.</para> </listitem> diff --git a/chapter08/libtool.xml b/chapter08/libtool.xml index 711adac05..2082c6cf9 100644 --- a/chapter08/libtool.xml +++ b/chapter08/libtool.xml @@ -61,7 +61,7 @@ percent.</para></note> <para>Five tests are known to fail in the LFS build environment due - to a circular dependency, but all tests pass if rechecked after + to a circular dependency, but all tests pass if rechecked after automake is installed.</para> <para>Install the package:</para> diff --git a/chapter08/man-db.xml b/chapter08/man-db.xml index 8afadffaf..b60e417e8 100644 --- a/chapter08/man-db.xml +++ b/chapter08/man-db.xml @@ -100,7 +100,7 @@ <varlistentry revision="sysv"> <term><parameter>--with-systemd...</parameter></term> <listitem> - <para>These parameters prevent installing unneeded systemd + <para>These parameters prevent installing unneeded systemd directories and files.</para> </listitem> </varlistentry> diff --git a/chapter08/meson.xml b/chapter08/meson.xml index 692513b06..60838af94 100644 --- a/chapter08/meson.xml +++ b/chapter08/meson.xml @@ -69,7 +69,7 @@ install -vDm644 data/shell-completions/zsh/_meson /usr/share/zsh/site-functions/ <variablelist> <title>The meaning of the install parameters:</title> - + <varlistentry> <term><parameter>--root=dest</parameter></term> <listitem> diff --git a/chapter08/ncurses.xml b/chapter08/ncurses.xml index 3fbca0c3c..3f2247586 100644 --- a/chapter08/ncurses.xml +++ b/chapter08/ncurses.xml @@ -132,7 +132,7 @@ cp -v -R doc/* /usr/share/doc/ncurses-&ncurses-version;</userinput></screen> <para>The instructions above don't create non-wide-character Ncurses libraries since no package installed by compiling from sources would link against them at runtime. However, the only known binary-only - applications that link against non-wide-character Ncurses libraries + applications that link against non-wide-character Ncurses libraries require version 5. If you must have such libraries because of some binary-only application or to be compliant with LSB, build the package again with the following commands:</para> @@ -143,7 +143,7 @@ cp -v -R doc/* /usr/share/doc/ncurses-&ncurses-version;</userinput></screen> --without-normal \ --without-debug \ --without-cxx-binding \ - --with-abi-version=5 + --with-abi-version=5 make sources libs cp -av lib/lib*.so.5* /usr/lib</userinput></screen> </note> @@ -160,27 +160,27 @@ cp -av lib/lib*.so.5* /usr/lib</userinput></screen> <seglistitem> <seg> - captoinfo (link to tic), - clear, - infocmp, + captoinfo (link to tic), + clear, + infocmp, infotocap (link to tic), - ncursesw6-config, - reset (link to tset), - tabs, - tic, - toe, - tput, and + ncursesw6-config, + reset (link to tset), + tabs, + tic, + toe, + tput, and tset </seg> <seg> libcursesw.so (symlink and linker script to libncursesw.so), - libformw.so, - libmenuw.so, + libformw.so, + libmenuw.so, libncursesw.so, libpanelw.so, and their non-wide-character counterparts without "w" in the library names.</seg> <seg> - /usr/share/tabset, + /usr/share/tabset, /usr/share/terminfo, and /usr/share/doc/ncurses-&ncurses-version; </seg> diff --git a/chapter08/ninja.xml b/chapter08/ninja.xml index 0fe0ccb73..4f3a25e88 100644 --- a/chapter08/ninja.xml +++ b/chapter08/ninja.xml @@ -50,21 +50,21 @@ <title>Installation of Ninja</title> <para>When run, ninja normally runs a maximum number of processes - in parallel. By default this is the number of cores on the system + in parallel. By default this is the number of cores on the system plus two. In some cases this can overheat a CPU or run a system out of memory. If run from the command line, passing a -jN parameter will limit the number of parallel processes, but some packages embed the execution of ninja and do not pass a -j parameter.</para> <para>Using the <emphasis>optional</emphasis> procedure below allows a user to - limit the number of parallel processes via an environment variable, + limit the number of parallel processes via an environment variable, NINJAJOBS. <emphasis role="bold">For example</emphasis>, setting: <screen>export NINJAJOBS=4</screen> will limit ninja to four parallel processes.</para> - <para>If desired, add the capability to use the environment variable + <para>If desired, add the capability to use the environment variable NINJAJOBS by running:</para> <screen><userinput remap="pre">sed -i '/int Guess/a \ diff --git a/chapter08/perl.xml b/chapter08/perl.xml index 0bb32c344..d22614a56 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 now 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 @@ -89,7 +89,7 @@ export BUILD_BZIP2=0</userinput></screen> <varlistentry> <term><parameter>-Dpager="/usr/bin/less -isR"</parameter></term> <listitem> - <para>This ensures that <userinput>less</userinput> is used instead + <para>This ensures that <userinput>less</userinput> is used instead of <userinput>more</userinput>.</para> </listitem> </varlistentry> diff --git a/chapter08/procps.xml b/chapter08/procps.xml index 8d49b60b4..dfdb949ab 100644 --- a/chapter08/procps.xml +++ b/chapter08/procps.xml @@ -28,7 +28,7 @@ <!-- TODO This note will probably not be needed at the next revision. --> <note> <para>This package extracts to the directory - <filename class="directory">procps-3.3.17</filename>, + <filename class="directory">procps-3.3.17</filename>, not the expected <filename class="directory">procps-ng-3.3.17</filename>.</para> </note> @@ -93,7 +93,7 @@ make check</userinput></screen> <para>Five tests related to pkill are known to fail due to a problem with tests that were not updated.</para> - + <para>Install the package:</para> <screen><userinput remap="install">make install</userinput></screen> diff --git a/chapter08/python.xml b/chapter08/python.xml index ddcaa17d2..a2c4a5bdd 100644 --- a/chapter08/python.xml +++ b/chapter08/python.xml @@ -103,7 +103,7 @@ <para>If desired, install the preformatted documentation:</para> -<screen><userinput remap="install">install -v -dm755 /usr/share/doc/python-&python-version;/html +<screen><userinput remap="install">install -v -dm755 /usr/share/doc/python-&python-version;/html tar --strip-components=1 \ --no-same-owner \ @@ -117,9 +117,9 @@ tar --strip-components=1 \ <varlistentry> <term><option>--no-same-owner</option> and <option>--no-same-permissions</option></term> <listitem> - <para>Ensure the installed files have the correct ownership and + <para>Ensure the installed files have the correct ownership and permissions. Without these options, using <application>tar</application> - will install the package files with the upstream creator's values. + will install the package files with the upstream creator's values. </para> </listitem> </varlistentry> @@ -144,7 +144,7 @@ tar --strip-components=1 \ libpython&python-minor;.so and libpython3.so </seg> <seg> - /usr/include/python&python-minor;, + /usr/include/python&python-minor;, /usr/lib/python3, and /usr/share/doc/python-&python-version; </seg> @@ -162,7 +162,7 @@ tar --strip-components=1 \ <para> is a <application>Python</application> program that reads <application>Python 2.x</application> source code and applies a - series of fixes to transform it into + series of fixes to transform it into valid <application>Python 3.x</application> code </para> <indexterm zone="ch-system-Python"> diff --git a/chapter08/revisedchroot.xml b/chapter08/revisedchroot.xml index 0c16ae622..b1317c92d 100644 --- a/chapter08/revisedchroot.xml +++ b/chapter08/revisedchroot.xml @@ -15,7 +15,7 @@ <screen><userinput>rm -rf /tmp/*</userinput></screen> <para>Now log out and reenter the chroot environment with an updated - chroot command. From now on, use this updated chroot command any time + chroot command. From now on, use this updated chroot command any time you need to reenter the chroot environment after exiting:</para> <screen role="nodump"><userinput>logout @@ -55,7 +55,7 @@ chroot "$LFS" /usr/bin/env -i \ <screen><userinput>find /usr -depth -name $(uname -m)-lfs-linux-gnu\* | xargs rm -rf</userinput></screen> - <para>Finally, remove the temporary 'tester' user account created at the + <para>Finally, remove the temporary 'tester' user account created at the beginning of the previous chapter.</para> <screen><userinput>userdel -r tester</userinput></screen> diff --git a/chapter08/stripping.xml b/chapter08/stripping.xml index 6841cd830..7f775b3d8 100644 --- a/chapter08/stripping.xml +++ b/chapter08/stripping.xml @@ -10,7 +10,7 @@ <title>Stripping</title> - <para>This section is optional. If the intended user is not a + <para>This section is optional. If the intended user is not a programmer and does not plan to do any debugging on the system software, the system size can be decreased by about 2 GB by removing the debugging symbols from binaries and @@ -24,9 +24,9 @@ backup of the LFS system in its current state.</para> <para>The debugging symbols for selected libraries are placed - in separate files. This debugging information is needed if running - regression tests that use <ulink - url='&blfs-book;/general/valgrind.html'>valgrind</ulink> or <ulink + in separate files. This debugging information is needed if running + regression tests that use <ulink + url='&blfs-book;/general/valgrind.html'>valgrind</ulink> or <ulink url='&blfs-book;/general/gdb.html'>gdb</ulink> later in BLFS. </para> @@ -41,7 +41,7 @@ rationale to use the <command>install</command> command here.</para> <note><para>The ELF loader's name is ld-linux-x86-64.so.2 on 64-bit systems - and ld-linux.so.2 on 32-bit systems. The contruct below selects the + and ld-linux.so.2 on 32-bit systems. The contruct below selects the correct name for the current architecture.</para></note> <!-- also of interest are libgfortan, libgo, libgomp, and libobjc from GCC --> @@ -50,10 +50,10 @@ <screen><userinput>save_usrlib="$(cd /usr/lib; ls ld-linux*) libc.so.6 libthread_db.so.1 - libquadmath.so.&libquadmath-version; + libquadmath.so.&libquadmath-version; libstdc++.so.&libstdcpp-version; - libitm.so.&libitm-version; - libatomic.so.&libatomic-version;" + libitm.so.&libitm-version; + libatomic.so.&libatomic-version;" cd /usr/lib @@ -93,9 +93,9 @@ for i in $(find /usr/lib -type f -name \*.so* ! -name \*dbg) \ $(find /usr/lib -type f -name \*.a) \ $(find /usr/{bin,sbin,libexec} -type f); do case "$online_usrbin $online_usrlib $save_usrlib" in - *$(basename $i)* ) + *$(basename $i)* ) ;; - * ) strip --strip-unneeded $i + * ) strip --strip-unneeded $i ;; esac done diff --git a/chapter08/systemd.xml b/chapter08/systemd.xml index 67b27b8d8..f003a1c47 100644 --- a/chapter08/systemd.xml +++ b/chapter08/systemd.xml @@ -205,7 +205,7 @@ meson --prefix=/usr \ use a network configuration other than what is provided by systemd-networkd:</para> <!-- Observed halting startup with dhcpcd handling the primary NIC --> - + <screen><userinput remap="adjust">systemctl disable systemd-time-wait-sync.service</userinput></screen> <!-- dev: 50-pid-max.conf is not removed in BLFS, so I commented the following out. @@ -213,7 +213,7 @@ meson --prefix=/usr \ <!-- <para>Prevent systemd from resetting the maximum PID value which causes some problems with packages and units in BLFS:</para> - + <screen><userinput remap="adjust">rm -f /usr/lib/sysctl.d/50-pid-max.conf</userinput></screen> --> @@ -251,8 +251,8 @@ meson --prefix=/usr \ <seg>/etc/binfmt.d, /etc/init.d, /etc/kernel, /etc/modules-load.d, /etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev, /etc/xdg/systemd, /usr/lib/systemd, /usr/lib/udev, /usr/include/systemd, - /usr/lib/binfmt.d, /usr/lib/environment.d, /usr/lib/kernel, - /usr/lib/modules-load.d, /usr/lib/sysctl.d, /usr/lib/systemd, + /usr/lib/binfmt.d, /usr/lib/environment.d, /usr/lib/kernel, + /usr/lib/modules-load.d, /usr/lib/sysctl.d, /usr/lib/systemd, /usr/lib/tmpfiles.d, /usr/share/doc/systemd-&systemd-version;, /usr/share/factory, /usr/share/systemd, /var/lib/systemd, and /var/log/journal</seg> @@ -323,7 +323,7 @@ meson --prefix=/usr \ <term><command>init</command></term> <listitem> <para>Is the first process to be started when the kernel has initialized - the hardware which takes over the boot process and starts all + the hardware which takes over the boot process and starts all processes according to its configuration files. In this case, it starts systemd</para> <indexterm zone="ch-system-systemd init"> @@ -389,7 +389,7 @@ meson --prefix=/usr \ <varlistentry id="networkctl"> <term><command>networkctl</command></term> <listitem> - <para>Is used to introspect and configure the state of the network + <para>Is used to introspect and configure the state of the network links configured by systemd-networkd</para> <indexterm zone="ch-system-systemd networkctl"> <primary sortas="b-networkctl">networkctl</primary> @@ -477,7 +477,7 @@ meson --prefix=/usr \ <varlistentry id="shutdown"> <term><command>shutdown</command></term> <listitem> - <para>Brings the system down in a safe and secure manner, signaling + <para>Brings the system down in a safe and secure manner, signaling all processes and notifying all logged-in users</para> <indexterm zone="ch-system-systemd shutdown"> <primary sortas="b-shutdown">shutdown</primary> @@ -774,7 +774,7 @@ meson --prefix=/usr \ <varlistentry id="systemd-tty-ask-password-agent"> <term><command>systemd-tty-ask-password-agent</command></term> <listitem> - <para>Is used to list and/or process pending systemd password + <para>Is used to list and/or process pending systemd password requests</para> <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent"> <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary> @@ -807,9 +807,9 @@ meson --prefix=/usr \ <varlistentry id="udevadm"> <term><command>udevadm</command></term> <listitem> - <para>Is a generic udev administration tool which controls the udevd - daemon, provides info from the Udev hardware database, monitors - uevents, waits for uevents to finish, tests udev configuration, and + <para>Is a generic udev administration tool which controls the udevd + daemon, provides info from the Udev hardware database, monitors + uevents, waits for uevents to finish, tests udev configuration, and triggers uevents for a given device</para> <indexterm zone="ch-system-systemd udevadm"> <primary sortas="b-udevadm">udevadm</primary> diff --git a/chapter08/sysvinit.xml b/chapter08/sysvinit.xml index 0a13f78e1..0d6914a45 100644 --- a/chapter08/sysvinit.xml +++ b/chapter08/sysvinit.xml @@ -91,7 +91,7 @@ <segtitle>Installed programs</segtitle> <seglistitem> - <seg>bootlogd, fstab-decode, halt, init, killall5, + <seg>bootlogd, fstab-decode, halt, init, killall5, poweroff (link to halt), reboot (link to halt), runlevel, shutdown, and telinit (link to init)</seg> </seglistitem> diff --git a/chapter08/tcl.xml b/chapter08/tcl.xml index 9f0a7401c..3776739c4 100644 --- a/chapter08/tcl.xml +++ b/chapter08/tcl.xml @@ -51,7 +51,7 @@ most important tools are working properly.</para> <!-- <para>Note that the Tcl package used here is a minimal version needed - to run the LFS tests. For the full package, see the + to run the LFS tests. For the full package, see the <ulink url='&blfs-book;general/tcl.html'>BLFS Tcl procedures</ulink>.</para>--> <para>First, unpack the documentation by issuing the following command:</para> @@ -155,11 +155,11 @@ unset SRCDIR</userinput></screen> <seglistitem> <seg> - tclsh (link to tclsh&tcl-major-version;) and + tclsh (link to tclsh&tcl-major-version;) and tclsh&tcl-major-version; </seg> <seg> - libtcl&tcl-major-version;.so and + libtcl&tcl-major-version;.so and libtclstub&tcl-major-version;.a </seg> </seglistitem> diff --git a/chapter08/texinfo.xml b/chapter08/texinfo.xml index 2543cd14d..42e81feae 100644 --- a/chapter08/texinfo.xml +++ b/chapter08/texinfo.xml @@ -196,7 +196,7 @@ popd</userinput></screen> <varlistentry id="texi2any"> <term><command>texi2any</command></term> <listitem> - <para>Translate Texinfo source documentation to + <para>Translate Texinfo source documentation to various other formats</para> <indexterm zone="ch-system-texinfo texi2any"> <primary sortas="b-texiany">texi2any</primary> diff --git a/chapter08/util-linux.xml b/chapter08/util-linux.xml index bcc3c98bd..341310556 100644 --- a/chapter08/util-linux.xml +++ b/chapter08/util-linux.xml @@ -75,7 +75,7 @@ runstatedir=/run</userinput></screen> <para>The --disable and --without options prevent warnings about - building components that require packages not in LFS or are + building components that require packages not in LFS or are inconsistent with programs installed by other packages.</para> <para>Compile the package:</para> @@ -138,14 +138,14 @@ su tester -c "make -k check"</userinput></screen> swapoff (link to swapon), swapon, switch_root, taskset, ul, umount, uname26, unshare, utmpdump, uuidd, uuidgen, uuidparse, wall, wdctl, whereis, wipefs, x86_64, and zramctl</seg> - <seg>libblkid.so, libfdisk.so, libmount.so, + <seg>libblkid.so, libfdisk.so, libmount.so, libsmartcols.so, and libuuid.so</seg> - <seg>/usr/include/blkid, - /usr/include/libfdisk, - /usr/include/libmount, - /usr/include/libsmartcols, - /usr/include/uuid, - /usr/share/doc/util-linux-&util-linux-version;, + <seg>/usr/include/blkid, + /usr/include/libfdisk, + /usr/include/libmount, + /usr/include/libsmartcols, + /usr/include/uuid, + /usr/share/doc/util-linux-&util-linux-version;, and /var/lib/hwclock</seg> </seglistitem> </segmentedlist> @@ -592,8 +592,8 @@ su tester -c "make -k check"</userinput></screen> <varlistentry id="last"> <term><command>last</command></term> <listitem> - <para>Shows which users last logged in (and out), searching back - through the <filename>/var/log/wtmp</filename> file; it also shows + <para>Shows which users last logged in (and out), searching back + through the <filename>/var/log/wtmp</filename> file; it also shows system boots, shutdowns, and run-level changes</para> <indexterm zone="ch-system-util-linux last"> <primary sortas="b-last">last</primary> @@ -604,7 +604,7 @@ su tester -c "make -k check"</userinput></screen> <varlistentry id="lastb"> <term><command>lastb</command></term> <listitem> - <para>Shows the failed login attempts, as logged in + <para>Shows the failed login attempts, as logged in <filename>/var/log/btmp</filename></para> <indexterm zone="ch-system-util-linux lastb"> <primary sortas="b-lastb">lastb</primary> @@ -759,7 +759,7 @@ su tester -c "make -k check"</userinput></screen> <varlistentry id="mesg"> <term><command>mesg</command></term> <listitem> - <para>Controls whether other users can send messages to the current + <para>Controls whether other users can send messages to the current user's terminal</para> <indexterm zone="ch-system-util-linux mesg"> <primary sortas="b-mesg">mesg</primary> @@ -1260,7 +1260,7 @@ su tester -c "make -k check"</userinput></screen> <varlistentry id="zramctl"> <term><command>zramctl</command></term> <listitem> - <para>A program to set up and control zram (compressed ram disk) + <para>A program to set up and control zram (compressed ram disk) devices</para> <indexterm zone="ch-system-util-linux zramctl"> <primary sortas="b-zramctl">zramctl</primary> diff --git a/chapter08/vim.xml b/chapter08/vim.xml index 4d06d5a08..11b5c2565 100644 --- a/chapter08/vim.xml +++ b/chapter08/vim.xml @@ -62,8 +62,8 @@ <screen><userinput remap="make">make</userinput></screen> - <para>To prepare the tests, ensure that user - <systemitem class="username">tester</systemitem> can write + <para>To prepare the tests, ensure that user + <systemitem class="username">tester</systemitem> can write to the source tree:</para> <screen><userinput remap="test">chown -Rv tester .</userinput></screen> @@ -133,7 +133,7 @@ done</userinput></screen> " Ensure defaults are set before customizing settings, not after source $VIMRUNTIME/defaults.vim -let skip_defaults_vim=1 +let skip_defaults_vim=1 set nocompatible set backspace=2 diff --git a/chapter08/xz.xml b/chapter08/xz.xml index 7f723482a..e4c43131c 100644 --- a/chapter08/xz.xml +++ b/chapter08/xz.xml @@ -74,34 +74,34 @@ <seglistitem> <seg> - lzcat (link to xz), - lzcmp (link to xzdiff), - lzdiff (link to xzdiff), - lzegrep (link to xzgrep), + lzcat (link to xz), + lzcmp (link to xzdiff), + lzdiff (link to xzdiff), + lzegrep (link to xzgrep), lzfgrep (link to xzgrep), - lzgrep (link to xzgrep), - lzless (link to xzless), + lzgrep (link to xzgrep), + lzless (link to xzless), lzma (link to xz), - lzmadec, - lzmainfo, + lzmadec, + lzmainfo, lzmore (link to xzmore), - unlzma (link to xz), - unxz (link to xz), - xz, + unlzma (link to xz), + unxz (link to xz), + xz, xzcat (link to xz), - xzcmp (link to xzdiff), - xzdec, - xzdiff, + xzcmp (link to xzdiff), + xzdec, + xzdiff, xzegrep (link to xzgrep), - xzfgrep (link to xzgrep), - xzgrep, - xzless, and + xzfgrep (link to xzgrep), + xzgrep, + xzless, and xzmore</seg> <seg> liblzma.so </seg> <seg> - /usr/include/lzma and + /usr/include/lzma and /usr/share/doc/xz-&xz-version; </seg> </seglistitem> diff --git a/chapter08/zstd.xml b/chapter08/zstd.xml index 1d0c603f6..881aba286 100644 --- a/chapter08/zstd.xml +++ b/chapter08/zstd.xml @@ -73,10 +73,10 @@ <segtitle>Installed library</segtitle> <seglistitem> - <seg>zstd, - zstdcat (link to zstd), - zstdgrep, - zstdless, + <seg>zstd, + zstdcat (link to zstd), + zstdgrep, + zstdless, zstdmt (link to zstd), and unzstd (link to zstd) </seg> |