gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-18 19:29:21 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'trunk' of git.linuxfromscratch.org:lfs into trunk

Browse Source
This commit is contained in:
Bruce Dubbs 2022-12-15 10:24:33 -06:00
commit dbaab99694
24 changed files with 237 additions and 240 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
bootscripts/ChangeLog
View File

@ -1135,7 +1135,7 @@ n/a - January 30, 2004:
* Changed the loadkeys script to run "loadkeys -d" and removed the need
for the /etc/sysconfig/keyboard file. The kbd patch fixes the
"loadkeys -d" behaviour.
"loadkeys -d" behavior.
1.6 - February 26th, 2002:

6
chapter08/bash.xml
View File

@ -23,7 +23,7 @@
<sect2 role="package">
<title/>
<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>

4
chapter08/binutils.xml
View File

@ -175,10 +175,10 @@ cd build</userinput></screen>
The test named <filename>ar with versioned solib</filename> is also
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
<literal>UNRESOLVED</literal> in the summary.</para>

42
chapter08/coreutils.xml
View File

@ -23,8 +23,8 @@
<sect2 role="package">
<title/>
<para>The Coreutils package contains utilities for showing and setting the
basic system characteristics.</para>
<para>The Coreutils package contains the basic utility programs
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
bugs to Coreutils maintainers, please check first if they are reproducible
without this patch.</para>
<para>Many bugs have been found in this patch. When reporting new
bugs to the Coreutils maintainers, please check first to see if
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
to be regenerated.</para>
build system, so the configuration files must
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
system date</para>
<para>Displays the current date and time in the given format, or sets the
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
pipe" in UNIX parlance, with the given names</para>
<para>Creates First-In, First-Outs (FIFOs), "named
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>

3
chapter08/diffutils.xml
View File

@ -79,8 +79,7 @@
<varlistentry id="cmp">
<term><command>cmp</command></term>
<listitem>
<para>Compares two files and reports whether or in which bytes they
differ</para>
<para>Compares two files and reports any differences byte by byte</para>
<indexterm zone="ch-system-diffutils cmp">
<primary sortas="b-cmp">cmp</primary>
</indexterm>

14
chapter08/findutils.xml
View File

@ -23,10 +23,12 @@
<sect2 role="package">
<title/>
<para>The Findutils package contains programs to find files. These programs
are provided to recursively search through a directory tree and to
<para>The Findutils package contains programs to find files. Programs
are provided to search through all the files in a directory tree and to
create, maintain, and search a database (often faster than the recursive
find, but is unreliable if the database has not been recently updated).</para>
find, but unreliable unless the database has been updated recently).
Findutils also supplies the <command>xargs</command> program, which
can be used to run a specified command on each file selected by a search.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
@ -63,9 +65,9 @@ esac</userinput></screen>
<varlistentry>
<term><parameter>--localstatedir</parameter></term>
<listitem>
<para>This option changes the location of the <command>locate</command>
database to be in <filename class="directory">/var/lib/locate</filename>,
which is FHS-compliant.</para>
<para>This option moves the <command>locate</command>
database to <filename class="directory">/var/lib/locate</filename>,
which is the FHS-compliant location.</para>
</listitem>
</varlistentry>

2
chapter08/gdbm.xml
View File

@ -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>

10
chapter08/gettext.xml
View File

@ -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>&lt;string&gt;</emphasis> strings and the
<emphasis>&lt;iostream&gt;</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>

4
chapter08/glibc.xml
View File

@ -387,10 +387,10 @@ unset ZONEINFO</userinput></screen>
<filename class="directory">zoneinfo/posix</filename>. It is
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>
</varlistentry>

15
chapter08/groff.xml
View File

@ -24,7 +24,7 @@
<title/>
<para>The Groff package contains programs for processing and formatting
text.</para>
text and images.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
@ -168,7 +168,7 @@
<varlistentry id="gperl">
<term><command>gperl</command></term>
<listitem>
<para>Preprocesor for groff, allowing addition of perl code
<para>Preprocesor for groff, allowing the insertion of perl code
into groff files</para>
<indexterm zone="ch-system-groff gperl">
<primary sortas="b-gperl">gperl</primary>
@ -179,8 +179,8 @@
<varlistentry id="gpinyin">
<term><command>gpinyin</command></term>
<listitem>
<para>Preprocesor for groff, allowing addition of Chinese
European-like language Pinyin into groff files.</para>
<para>Preprocesor for groff, allowing the insertion of Pinyin
(Mandarin Chinese spelled with the Roman alphabet) into groff files.</para>
<indexterm zone="ch-system-groff gpinyin">
<primary sortas="b-gpinyin">gpinyin</primary>
</indexterm>
@ -190,7 +190,8 @@
<varlistentry id="grap2graph">
<term><command>grap2graph</command></term>
<listitem>
<para>Converts a grap diagram into a cropped bitmap image</para>
<para>Converts a grap program file into a cropped bitmap image
(grap is an old Unix programming language for creating diagrams)</para>
<indexterm zone="ch-system-groff grap2graph">
<primary sortas="b-grap2graph">grap2graph</primary>
</indexterm>
@ -211,7 +212,7 @@
<term><command>grodvi</command></term>
<listitem>
<para>A driver for <command>groff</command> that produces TeX dvi
format</para>
format output files</para>
<indexterm zone="ch-system-groff grodvi">
<primary sortas="b-grodvi">grodvi</primary>
</indexterm>
@ -221,7 +222,7 @@
<varlistentry id="groff">
<term><command>groff</command></term>
<listitem>
<para>A front-end to the groff document formatting system; normally, it
<para>A front end to the groff document formatting system; normally, it
runs the <command>troff</command> program and a post-processor
appropriate for the selected device</para>
<indexterm zone="ch-system-groff groff">

52
chapter08/grub.xml
View File

@ -44,9 +44,9 @@
<para>
If your system has UEFI support and you wish to boot LFS with UEFI,
you can skip this package in LFS,
and install GRUB with UEFI support (and its dependencies) following
<ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink>
at the end of this chapter.
and install GRUB with UEFI support (and its dependencies) by following
the instructions on
<ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink>.
</para>
</note>
@ -56,9 +56,9 @@
<screen><userinput remap='pre'>unset {C,CPP,CXX,LD}FLAGS</userinput></screen>
<para>Don't try <quote>tuning</quote> this package with custom
compilation flags: this package is a bootloader, with low-level
operations in the source code which is likely to be broken by some
aggressive optimizations.</para>
compilation flags. This package is a bootloader. The low-level
operations in the source code may be broken by
aggressive optimization.</para>
</warning>
<para>Prepare GRUB for compilation:</para>
@ -75,7 +75,7 @@
<term><parameter>--disable-werror</parameter></term>
<listitem>
<para>This allows the build to complete with warnings introduced
by more recent Flex versions.</para>
by more recent versions of Flex.</para>
</listitem>
</varlistentry>
@ -83,7 +83,7 @@
<term><parameter>--disable-efiemu</parameter></term>
<listitem>
<para>This option minimizes what is built by disabling a feature and
testing programs not needed for LFS.</para>
eliminating some test programs not needed for LFS.</para>
</listitem>
</varlistentry>
@ -102,7 +102,7 @@
<screen><userinput remap="install">make install
mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userinput></screen>
<para>Using GRUB to make your LFS system bootable will be discussed in
<para>Making your LFS system bootable with GRUB will be discussed in
<xref linkend="ch-bootable-grub"/>.</para>
</sect2>
@ -138,7 +138,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-bios-setup">
<term><command>grub-bios-setup</command></term>
<listitem>
<para>Is a helper program for grub-install</para>
<para>Is a helper program for <command>grub-install</command></para>
<indexterm zone="ch-system-grub grub-bios-setup">
<primary sortas="b-grub-bios-setup">grub-bios-setup</primary>
</indexterm>
@ -148,7 +148,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-editenv">
<term><command>grub-editenv</command></term>
<listitem>
<para>A tool to edit the environment block</para>
<para>Is a tool to edit the environment block</para>
<indexterm zone="ch-system-grub grub-editenv">
<primary sortas="b-grub-editenv">grub-editenv</primary>
</indexterm>
@ -158,7 +158,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-file">
<term><command>grub-file</command></term>
<listitem>
<para>Checks if FILE is of the specified type.</para>
<para>Checks to see if the given file is of the specified type</para>
<indexterm zone="ch-system-grub grub-file">
<primary sortas="b-grub-file">grub-file</primary>
</indexterm>
@ -168,7 +168,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-fstest">
<term><command>grub-fstest</command></term>
<listitem>
<para>Tool to debug the filesystem driver</para>
<para>Is a tool to debug the filesystem driver</para>
<indexterm zone="ch-system-grub grub-fstest">
<primary sortas="b-grub-fstest">grub-fstest</primary>
</indexterm>
@ -178,7 +178,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-glue-efi">
<term><command>grub-glue-efi</command></term>
<listitem>
<para>Glue 32-bit and 64-bit binary into Apple universal one.</para>
<para>Glues 32-bit and 64-bit binaries into a single file (for Apple machines)</para>
<indexterm zone="ch-system-grub grub-glue-efi">
<primary sortas="b-grub-glue-efi">grub-glue-efi</primary>
</indexterm>
@ -188,7 +188,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-install">
<term><command>grub-install</command></term>
<listitem>
<para>Install GRUB on your drive</para>
<para>Installs GRUB on your drive</para>
<indexterm zone="ch-system-grub grub-install">
<primary sortas="b-grub-install">grub-install</primary>
</indexterm>
@ -198,7 +198,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-kbdcomp">
<term><command>grub-kbdcomp</command></term>
<listitem>
<para>Script that converts an xkb layout into one recognized by
<para>Is a script that converts an xkb layout into one recognized by
GRUB</para>
<indexterm zone="ch-system-grub grub-kbdcomp">
<primary sortas="b-grub-kbdcomp">grub-kbdcomp</primary>
@ -209,7 +209,8 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-macbless">
<term><command>grub-macbless</command></term>
<listitem>
<para>Mac-style bless on HFS or HFS+ files</para>
<para>Is the Mac-style bless for HFS or HFS+ file systems (<command>bless</command>
is peculiar to Apple machines; it makes a device bootable)</para>
<indexterm zone="ch-system-grub grub-macbless">
<primary sortas="b-grub-macbless">grub-macbless</primary>
</indexterm>
@ -230,7 +231,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-mkconfig">
<term><command>grub-mkconfig</command></term>
<listitem>
<para>Generate a grub config file</para>
<para>Generates a <filename>grub.cfg</filename> file</para>
<indexterm zone="ch-system-grub grub-mkconfig">
<primary sortas="b-grub-mkconfig">grub-mkconfig</primary>
</indexterm>
@ -240,7 +241,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-mkimage">
<term><command>grub-mkimage</command></term>
<listitem>
<para>Make a bootable image of GRUB</para>
<para>Makes a bootable image of GRUB</para>
<indexterm zone="ch-system-grub grub-mkimage">
<primary sortas="b-grub-mkimage">grub-mkimage</primary>
</indexterm>
@ -291,7 +292,8 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-mkrescue">
<term><command>grub-mkrescue</command></term>
<listitem>
<para>Make a bootable image of GRUB suitable for a floppy disk or CDROM/DVD</para>
<para>Makes a bootable image of GRUB suitable for a floppy disk,
CDROM/DVD, or a USB drive</para>
<indexterm zone="ch-system-grub grub-mkrescue">
<primary sortas="b-grub-mkrescue">grub-mkrescue</primary>
</indexterm>
@ -311,7 +313,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-ofpathname">
<term><command>grub-ofpathname</command></term>
<listitem>
<para>Is a helper program that prints the path of a GRUB device</para>
<para>Is a helper program that prints the path to a GRUB device</para>
<indexterm zone="ch-system-grub grub-ofpathname">
<primary sortas="b-grub-ofpathname">grub-ofpathname</primary>
</indexterm>
@ -321,7 +323,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-probe">
<term><command>grub-probe</command></term>
<listitem>
<para>Probe device information for a given path or device</para>
<para>Probes device information for a given path or device</para>
<indexterm zone="ch-system-grub grub-probe">
<primary sortas="b-grub-probe">grub-probe</primary>
</indexterm>
@ -341,7 +343,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-render-label">
<term><command>grub-render-label</command></term>
<listitem>
<para>Render Apple .disk_label for Apple Macs</para>
<para>Renders Apple .disk_label for Apple Macs</para>
<indexterm zone="ch-system-grub grub-render-label">
<primary sortas="b-grub-render-label">grub-render-label</primary>
</indexterm>
@ -351,7 +353,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-script-check">
<term><command>grub-script-check</command></term>
<listitem>
<para>Checks GRUB configuration script for syntax errors</para>
<para>Checks the GRUB configuration script for syntax errors</para>
<indexterm zone="ch-system-grub grub-script-check">
<primary sortas="b-grub-script-check">grub-script-check</primary>
</indexterm>
@ -381,7 +383,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-syslinux2cfg">
<term><command>grub-syslinux2cfg</command></term>
<listitem>
<para>Transform a syslinux config file into grub.cfg format</para>
<para>Transforms a syslinux config file into grub.cfg format</para>
<indexterm zone="ch-system-grub grub-syslinux2cfg">
<primary sortas="b-grub-syslinux2cfg">grub-syslinux2cfg</primary>
</indexterm>

74
chapter08/iproute2.xml
View File

@ -42,12 +42,12 @@
<title>Installation of IPRoute2</title>
<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.
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"/>.
be built since it depends on Berkeley DB, which is not installed in
LFS. However, a directory and a man page for <command>arpd</command> will still
be installed. Prevent this by running the commands shown below.
(If the <command>arpd</command> program is needed,
instructions for compiling Berkeley DB can be found in the BLFS book at
<ulink url="&blfs-book;server/db.html"/>.)
</para>
<screen><userinput remap="pre">sed -i /ARPD/d Makefile
@ -93,8 +93,8 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version;</userinput></sc
<segtitle>Installed directories</segtitle>
<seglistitem>
<seg>bridge, ctstat (link to lnstat), genl, ifcfg, ifstat, ip, lnstat,
nstat, routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
<seg>bridge, ctstat (link to lnstat), genl, ifstat, ip, lnstat,
nstat, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
and tc</seg>
<seg>/etc/iproute2, /usr/lib/tc, and /usr/share/doc/iproute2-&iproute2-version;
</seg>
@ -129,31 +129,18 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version;</userinput></sc
<varlistentry id="genl">
<term><command>genl</command></term>
<listitem>
<para>Generic netlink utility frontend</para>
<para>Generic netlink utility front end</para>
<indexterm zone="ch-system-iproute2 genl">
<primary sortas="b-genl">genl</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ifcfg">
<term><command>ifcfg</command></term>
<listitem>
<para>A shell script wrapper for the <command>ip</command> command
[Note that it requires the <command>arping</command> and
<command>rdisk</command> programs from the
iputils package found at <ulink url="http://www.skbuff.net/iputils/"/>.]</para>
<indexterm zone="ch-system-iproute2 ifcfg">
<primary sortas="b-ifcfg">ifcfg</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ifstat">
<term><command>ifstat</command></term>
<listitem>
<para>Shows the interface statistics, including the amount of
transmitted and received packets by interface</para>
<para>Shows interface statistics, including the number of
packets transmitted and received, by interface</para>
<indexterm zone="ch-system-iproute2 ifstat">
<primary sortas="b-ifstat">ifstat</primary>
</indexterm>
@ -163,7 +150,7 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version;</userinput></sc
<varlistentry id="ip">
<term><command>ip</command></term>
<listitem>
<para>The main executable. It has several different functions:</para>
<para>The main executable. It has several different functions, including these:</para>
<para><command>ip link <replaceable>&lt;device&gt;</replaceable></command>
allows users to look at the state of devices and to make changes</para>
@ -213,28 +200,17 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version;</userinput></sc
<varlistentry id="nstat">
<term><command>nstat</command></term>
<listitem>
<para>Shows network statistics</para>
<para>Displays network statistics</para>
<indexterm zone="ch-system-iproute2 nstat">
<primary sortas="b-nstat">nstat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="routef">
<term><command>routef</command></term>
<listitem>
<para>A component of <command>ip route</command>. This is for flushing
the routing tables</para>
<indexterm zone="ch-system-iproute2 routef">
<primary sortas="b-routef">routef</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="routel">
<term><command>routel</command></term>
<listitem>
<para>A component of <command>ip route</command>. This is for listing
<para>A component of <command>ip route</command>, for listing
the routing tables</para>
<indexterm zone="ch-system-iproute2 routel">
<primary sortas="b-routel">routel</primary>
@ -266,7 +242,7 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version;</userinput></sc
<varlistentry id="rtpr">
<term><command>rtpr</command></term>
<listitem>
<para>Converts the output of <command>ip -o</command> back into a
<para>Converts the output of <command>ip -o</command> into a
readable form</para>
<indexterm zone="ch-system-iproute2 rtpr">
<primary sortas="b-rtpr">rtpr</primary>
@ -298,23 +274,21 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version;</userinput></sc
<varlistentry id="tc">
<term><command>tc</command></term>
<listitem>
<para>Traffic Controlling Executable; this is for Quality Of Service
(QOS) and Class Of Service (COS) implementations</para>
<para>Traffic control for Quality of Service
(QoS) and Class of Service (CoS) implementations</para>
<para><command>tc qdisc</command> allows users to setup the queueing
<para><command>tc qdisc</command> allows users to set up the queueing
discipline</para>
<para><command>tc class</command> allows users to setup classes based
<para><command>tc class</command> allows users to set up classes based
on the queuing discipline scheduling</para>
<para><command>tc estimator</command> allows users to estimate the
network flow into a network</para>
<para><command>tc filter</command> allows users to setup the QOS/COS
<para><command>tc filter</command> allows users to set up the QoS/CoS
packet filtering</para>
<para><command>tc policy</command> allows users to setup 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>
</indexterm>

2
chapter08/kbd.xml
View File

@ -41,7 +41,7 @@
<sect2 role="installation">
<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>

6
chapter08/libelf.xml
View File

@ -41,8 +41,8 @@
<sect2 role="installation">
<title>Installation of Libelf</title>
<para>Libelf is part of elfutils-&elfutils-version; package. Use
the elfutils-&elfutils-version;.tar.bz2 as the source tarball.</para>
<para>Libelf is part of the elfutils-&elfutils-version; package. Use
the elfutils-&elfutils-version;.tar.bz2 file as the source tarball.</para>
<para>Prepare Libelf for compilation:</para>
@ -59,7 +59,7 @@
<screen><userinput remap="test">make check</userinput></screen>
<para>One test named <filename>run-low_high_pc.sh</filename> is known to
fail on 32-bit x86 system.</para>
fail on 32-bit x86 systems.</para>
<para>Install only Libelf:</para>

20
chapter08/libffi.xml
View File

@ -26,6 +26,11 @@
<para>The Libffi library provides a portable, high level programming
interface to various calling conventions. This allows a programmer to call
any function specified by a call interface description at run time.</para>
<para>FFI stands for Foreign Function Interface. An FFI allows a program written
in one language to call a program written in another language. Specifically,
Libffi can provide a bridge between an interpreter like Perl, or Python, and
shared library subroutines written in C, or C++.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
@ -43,16 +48,17 @@
<title>Installation of Libffi</title>
<note>
<para>Similar to GMP, libffi builds with optimizations specific
<para>Like GMP, Libffi builds with optimizations specific
to the processor in use. If building for another system, change the
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>
<para>Prepare libffi for compilation:</para>
<para>Prepare Libffi for compilation:</para>
<screen><userinput remap="configure">./configure --prefix=/usr \
--disable-static \
@ -67,7 +73,7 @@
<listitem>
<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
may not be correct. 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
@ -80,8 +86,8 @@
<!-- To editors: try to remove it once GJS fixed (at GNOME 43) -->
<term><parameter>--disable-exec-static-tramp</parameter></term>
<listitem>
<para>Disable static trampoline support. It's a new security
feature in libffi, but some BLFS packages (notably
<para>Disable static trampoline support, a new security
feature in Libffi. Some BLFS packages (notably
<application>GJS</application>) have not been adapted for it.</para>
</listitem>
</varlistentry>
@ -121,7 +127,7 @@
<varlistentry id="libffi">
<term><filename class="libraryfile">libffi</filename></term>
<listitem>
<para>contains the foreign function interface API functions</para>
<para>Contains the foreign function interface API functions</para>
<indexterm zone="ch-system-libffi">
<primary sortas="c-libffi">libffi</primary>
</indexterm>

8
chapter08/libtool.xml
View File

@ -24,7 +24,7 @@
<title/>
<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&lt;N&gt;</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>
@ -123,7 +123,7 @@
<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 loaded libraries</para>
<indexterm zone="ch-system-libtool libltdl">
<primary sortas="c-libltdl">libltdl</primary>
</indexterm>

2
chapter08/m4.xml
View File

@ -89,7 +89,7 @@ echo "#define _IO_IN_BACKUP 0x100" >> lib/stdio-impl.h</userinput></screen>
<command>m4</command> has built-in functions for including named
files, running Unix commands, performing integer arithmetic,
manipulating text, recursion, etc. The <command>m4</command> program
can be used either as a front-end to a compiler or as a macro processor
can be used either as a front end to a compiler or as a macro processor
in its own right</para>
<indexterm zone="ch-system-m4 m4">
<primary sortas="b-m4">m4</primary>

15
chapter08/meson.xml
View File

@ -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
systemd. On the other hand, meson/ninja is a powerful build system,
which is expected to be used more and more often. It is required for
<para>This section is not strictly required when LFS does not use
systemd. On the other hand, Meson, along with Ninja, makes
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>

26
chapter08/ninja.xml
View File

@ -36,10 +36,10 @@
</segmentedlist>
<tip revision="sysv">
<para>This section is not strictly required for LFS if not using
systemd. On the other hand, ninja associated to meson makes
<para>This section is not strictly required when LFS does not use
systemd. On the other hand, Ninja, along with Meson, makes
a powerful build system combination,
which is expected to be used more and more often. It is required for
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>
@ -49,12 +49,12 @@
<sect2 role="installation">
<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
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>When run, <command>ninja</command> normally utilizes the greatest
possible number of processes in parallel. By default this is the number of cores on the system,
plus two. This may overheat the CPU, or make the system run out
of memory. When <command>ninja</command> is invoked from the command line, passing the -jN parameter
will limit the number of parallel processes. Some packages
embed the execution of <command>ninja</command>, and do not pass the -j parameter on to it.</para>
<para>Using the <emphasis>optional</emphasis> procedure below allows a user to
limit the number of parallel processes via an environment variable,
@ -62,10 +62,10 @@
<screen>export NINJAJOBS=4</screen>
will limit ninja to four parallel processes.</para>
will limit <command>ninja</command> to four parallel processes.</para>
<para>If desired, add the capability to use the environment variable
NINJAJOBS by running:</para>
<para>If desired, make <command>ninja</command> recognize the environment variable
NINJAJOBS by running the stream editor:</para>
<screen><userinput remap="pre">sed -i '/int Guess/a \
int j = 0;\
@ -84,7 +84,7 @@
<varlistentry>
<term><parameter>--bootstrap</parameter></term>
<listitem>
<para>This parameter forces ninja to rebuild itself for the current
<para>This parameter forces Ninja to rebuild itself for the current
system.</para>
</listitem>
</varlistentry>

6
chapter08/openssl.xml
View File

@ -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>

31
chapter08/perl.xml
View File

@ -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,34 @@ 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>
based on the MAJOR.MINOR version of Perl (&perl-version-min;) which
allows upgrading Perl to newer patch levels (the patch level is
the last dot separated part in the full version string like
&perl-version;) without reinstalling all of the modules.</para>
</listitem>
</varlistentry>
@ -185,7 +186,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 +251,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 +285,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>

92
chapter08/python.xml
View File

@ -25,7 +25,8 @@
<para>The Python 3 package contains the Python development environment. It
is useful for object-oriented programming, writing scripts, prototyping
large programs, or developing entire applications.</para>
large programs, and developing entire applications. Python is an interpreted
computer language.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
@ -56,7 +57,7 @@
<varlistentry>
<term><parameter>--with-system-expat</parameter></term>
<listitem>
<para>This switch enables linking against system version of
<para>This switch enables linking against the system version of
<application>Expat</application>.</para>
</listitem>
</varlistentry>
@ -64,15 +65,19 @@
<varlistentry>
<term><parameter>--with-system-ffi</parameter></term>
<listitem>
<para>This switch enables linking against system version of
<application>libffi</application>.</para>
<para>This switch enables linking against the system version of
<filename class='libraryfile'>libffi.so</filename>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>--enable-optimizations</parameter></term>
<listitem>
<para>This switch enables stable, but expensive, optimizations.</para>
<para>This switch enables extensive, but time-consuming, optimization
steps. The interpreter is built twice; tests performed on the first
build are used to improve the optimized final version.</para>
<!-- This description was drawn from the README.rst file
in the Python-3.11.0 package. -->
</listitem>
</varlistentry>
@ -84,7 +89,7 @@
<para>Running the tests at this point is not recommended. The
tests are known to hang indefinitely in the partial LFS environment.
If desired, the tests can be rerun at the end of this chapter or
If desired, the tests can be rerun at the end of this chapter, or
when Python 3 is reinstalled in BLFS. To run the tests anyway,
issue <command>make test</command>.</para>
@ -92,29 +97,34 @@
<screen><userinput remap="install">make install</userinput></screen>
<para>In several places we use the <command>pip3</command> command to
<para>We use the <command>pip3</command> command to
install Python 3 programs and modules for all users as
<systemitem class='username'>root</systemitem>. This conflicts
with the Python developers recommendation to install packages into a
virtual environment or the home directory of a regular user (by running
<command>pip3</command> as this user). To this end, a multi-line warning
is written when using <command>pip3</command> as the
<systemitem class='username'>root</systemitem> user. The main reason
of this recommendation is for avoiding a conflict with the system
package manager (<command>dpkg</command> for example), but LFS does not
have a system-wide package manager so this is not a problem. And,
<command>pip3</command> will attempt to check for a new version of
itself whenever it's run. As domain name resolving is not configured
yet in LFS chroot environment, it will fail to check for a new version
and produce a warning. Once we boot the LFS system and set up network
connection, it will then produce a warning telling the user to update it
from a pre-built wheel on PyPI if any new version is available. But LFS
consider <command>pip3</command> a part of Python 3 so it should not be
updated separately, and an update from a pre-built wheel will deviate
from our purpose to build a Linux system from source code. So the
warning for a new <command>pip3</command> version should be ignored as
well. If desired, suppress these warnings by running the following
commands:</para>
<systemitem class='username'>root</systemitem> in several places in this book.
This conflicts with the Python developers' recommendation: to install packages into a
virtual environment, or into the home directory of a regular user (by running
<command>pip3</command> as this user). A multi-line warning
is triggered whenever <command>pip3</command> is issued by the
<systemitem class='username'>root</systemitem> user.</para>
<para>The main reason
for the recommendation is to avoid conflicts with the system's
package manager (<command>dpkg</command>, for example). LFS does not
have a system-wide package manager, so this is not a problem. Also,
<command>pip3</command> will check for a new version of
itself whenever it's run. Since domain name resolution is not yet configured
in the LFS chroot environment, <command>pip3</command> cannot check
for a new version of itself, and will
produce a warning. </para>
<para>After we boot the LFS system and set up a network connection,
a different warning will be issued, telling the user to update <command>pip3</command>
from a pre-built wheel on PyPI (whenever a new version is available). But LFS
considers <command>pip3</command> to be a part of Python 3, so it should not be
updated separately. Also, an update from a pre-built wheel would deviate
from our objective: to build a Linux system from source code. So the
warning about a new version of <command>pip3</command> should be ignored as
well. If you wish, you can suppress all these warnings by running the following
command, which creates a configuration file:</para>
<screen><userinput remap="install">cat &gt; /etc/pip.conf &lt;&lt; EOF
<literal>[global]
@ -130,20 +140,20 @@ EOF
<important>
<para>
In LFS and BLFS we normally build and install Python modules with the
<command>pip3</command> command. Please take care that the
<command>pip3 install</command> commands in both the books should be
run as the &root; user unless it's for a Python virtual environment.
Running a <command>pip3 install</command> as a non-&root; user may seem
to work fine, but it will cause the installed module to be inaccessible
<command>pip3</command> command. Please be sure that the
<command>pip3 install</command> commands in both books are
run as the &root; user (unless it's for a Python virtual environment).
Running <command>pip3 install</command> as a non-&root; user may seem
to work, but it will cause the installed module to be inaccessible
by other users.
</para>
<para>
<command>pip3 install</command> will not reinstall an already installed
module by default. For using the <command>pip3 install</command>
module automatically. When using the <command>pip3 install</command>
command to upgrade a module (for example, from meson-0.61.3 to
meson-0.62.0), insert the option <parameter>--upgrade</parameter> into
the command line. If it's really necessary to downgrade a module or
the command line. If it's really necessary to downgrade a module, or
reinstall the same version for some reason, insert
<parameter>--force-reinstall --no-deps</parameter> into the command
line.
@ -167,7 +177,7 @@ tar --strip-components=1 \
<term><option>--no-same-owner</option> and <option>--no-same-permissions</option></term>
<listitem>
<para>Ensure the installed files have the correct ownership and
permissions. Without these options, using <application>tar</application>
permissions. Without these options, <application>tar</application>
will install the package files with the upstream creator's values.
</para>
</listitem>
@ -226,8 +236,8 @@ tar --strip-components=1 \
<para>
is a wrapper script that opens a <application>Python</application>
aware GUI editor. For this script to run, you must have installed
<application>Tk</application> before Python so that the Tkinter
Python module is built
<application>Tk</application> before Python, so that the Tkinter
Python module is built.
</para>
<indexterm zone="ch-system-Python">
<primary sortas="b-idle3">idle3</primary>
@ -240,7 +250,7 @@ tar --strip-components=1 \
<listitem>
<para>
The package installer for Python. You can use pip to install
packages from Python Package Index and other indexes
packages from Python Package Index and other indexes.
</para>
<indexterm zone="ch-system-Python">
<primary sortas="b-pip3">pip3</primary>
@ -264,8 +274,8 @@ tar --strip-components=1 \
<term><command>python3</command></term>
<listitem>
<para>
is an interpreted, interactive, object-oriented programming
language
is the interpreter for Python, an interpreted, interactive,
object-oriented programming language
</para>
<indexterm zone="ch-system-Python">
<primary sortas="b-python3">python3</primary>

19
chapter08/vim.xml
View File

@ -54,7 +54,7 @@
<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>
@ -83,7 +83,7 @@
<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
symlink for both the binary and the man page in the provided
@ -94,7 +94,7 @@ for L in /usr/share/man/{,*/}man1/vim.1; do
ln -sv vim.1 $(dirname $L)/vi.1
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
class="directory">/usr/share/doc/vim-&vim-version;</filename>, making
@ -103,10 +103,10 @@ done</userinput></screen>
<screen><userinput remap="install">ln -sv ../&vim-docdir;/doc /usr/share/doc/vim-&vim-version;</userinput></screen>
<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>
@ -166,8 +166,8 @@ EOF</userinput></screen>
<screen role="nodump"><userinput>vim -c ':options'</userinput></screen>
<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
and character encoding from
@ -175,7 +175,7 @@ EOF</userinput></screen>
<filename class='directory'>
/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>
<screen><literal>set spelllang=en,ru
@ -297,7 +297,8 @@ set spell</literal></screen>
<term><command>xxd</command></term>
<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>
</indexterm>

22
chapter08/wheel.xml
View File

@ -40,21 +40,21 @@
<sect2 role="installation">
<title>Installation of Wheel</title>
<para>Compile wheel with the following command:</para>
<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>
<para>Install Wheel with the following command:</para>
<screen><userinput remap="install">pip3 install --no-index --find-links=dist wheel</userinput></screen>
<variablelist>
<title>The meaning of the pip3 commands:</title>
<title>The meaning of the pip3 configuration options and commands:</title>
<varlistentry>
<term><envar>PYTHONPATH=src</envar></term>
<listitem>
<para>Allow using this package (not installed yet) to build a
<para>Allows this package (not installed yet) to build a
wheel archive for itself, to avoid a chicken-or-egg problem.</para>
</listitem>
</varlistentry>
@ -62,14 +62,14 @@
<varlistentry>
<term><command>wheel</command></term>
<listitem>
<para>Build wheel archive for this package.</para>
<para>This command builds the wheel archive for this package.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>-w dist</parameter></term>
<listitem>
<para>Put the created wheels into the
<para>Instructs pip to put the created wheel into the
<filename class='directory'>dist</filename> directory.</para>
</listitem>
</varlistentry>
@ -77,7 +77,7 @@
<varlistentry>
<term><command>install</command></term>
<listitem>
<para>Install the package.</para>
<para>This command installs the package.</para>
</listitem>
</varlistentry>
@ -86,9 +86,9 @@
<parameter>--no-deps</parameter>, and
<parameter>--no-index</parameter></term>
<listitem>
<para>Prevent pip from fetching files from the online package
<para>These options prevent 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 these
pip won't need to fetch any files in the first place; these
options add some safety in case of user error.</para>
</listitem>
</varlistentry>
@ -96,7 +96,7 @@
<varlistentry>
<term><parameter>--find-links dist</parameter></term>
<listitem>
<para>Search wheel archives from the
<para>Instructs pip to search for wheel archives in the
<filename class='directory'>dist</filename> directory.</para>
</listitem>
</varlistentry>
@ -128,7 +128,7 @@
<term><command>wheel</command></term>
<listitem>
<para>
is an utility to unpack, pack, or convert wheel packages
is a utility to unpack, pack, or convert wheel archives
</para>
<indexterm zone="ch-system-wheel">
<primary sortas="b-wheel">wheel</primary>