diff --git a/chapter06/coreutils.xml b/chapter06/coreutils.xml index 00de6addf..4622366aa 100644 --- a/chapter06/coreutils.xml +++ b/chapter06/coreutils.xml @@ -38,7 +38,7 @@ fixes this behavior for Intel architectures: patch -Np1 -i ../&coreutils-uname-patch; -Prevent Coreutils from installing binaries that will be later be +Prevent Coreutils from installing binaries that will later be installed by other packages: patch -Np1 -i ../&coreutils-suppress-patch; @@ -51,10 +51,11 @@ installed by other packages: make -The test suite of Coreutils makes several invalid assumptions about the -presence of system users and groups. Therefore, additional items need to be set -up before running the tests. Skip down to Install the package if -not running the test suite. +The test suite of Coreutils makes several assumptions about the presence +of system users and groups that are not valid within the minimal environment +that exists at the moment. Therefore, additional items need to be set up before +running the tests. Skip down to Install the package if not +running the test suite. Create two dummy groups and a dummy user: diff --git a/chapter06/e2fsprogs.xml b/chapter06/e2fsprogs.xml index dae7254c3..2df545de7 100644 --- a/chapter06/e2fsprogs.xml +++ b/chapter06/e2fsprogs.xml @@ -52,15 +52,15 @@ cd build --with-root-prefix="" -Certain programs (such as the -e2fsck program) are considered essential programs. -When, for example, /usr is not -mounted, these essential programs need to be available. They belong in -directories like /lib and -/sbin. If this option is not -passed to E2fsprogs' configure, the programs are installed into the -/usr directory, which is not -where they should be. +Certain programs (such as the e2fsck program) +are considered essential programs. When, for example, /usr is not mounted, these essential programs need +to be available. They belong in directories like /lib and /sbin. If this option is not passed to E2fsprogs' +configure, the programs are installed into the /usr directory. + @@ -87,7 +87,7 @@ information regarding EVMS. To test the results, issue: make check. -Install most of the package: +Install the binaries and documentation: make install @@ -264,8 +264,7 @@ class="libraryfile">libss subsystem library mke2fs -Is used to create a second extended file system on the given -device +Creates an ext2 or ext3 file system on the given device mke2fs diff --git a/chapter06/file.xml b/chapter06/file.xml index 354f930f8..ff33100fa 100644 --- a/chapter06/file.xml +++ b/chapter06/file.xml @@ -12,7 +12,8 @@ File -<para>The File package contains a utility for determining the type of files.</para> +<para>The File package contains a utility for determining the type of a given +file or files.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> diff --git a/chapter06/findutils.xml b/chapter06/findutils.xml index 378c79613..0c34ac14b 100644 --- a/chapter06/findutils.xml +++ b/chapter06/findutils.xml @@ -38,7 +38,7 @@ Diffutils, GCC, Gettext, Glibc, Grep, Make and Sed</seg></seglistitem> <screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/locate \ --localstatedir=/var/lib/locate</userinput></screen> -<para>The <parameter>localstatedir</parameter> directive above changes the +<para>The <parameter>localstatedir</parameter> option above changes the location of the <command>locate</command> database to be in <filename class="directory">/var/lib/locate</filename>, which is FHS-compliant.</para> diff --git a/chapter06/flex.xml b/chapter06/flex.xml index 5a4ab3368..2a0e66910 100644 --- a/chapter06/flex.xml +++ b/chapter06/flex.xml @@ -117,7 +117,7 @@ program</para> <varlistentry id="lex"> <term><command>lex</command></term> <listitem> -<para>Script that runs <command>flex</command> in <command>lex</command> +<para>A script that runs <command>flex</command> in <command>lex</command> emulation mode</para> <indexterm zone="ch-system-flex lex"><primary sortas="b-lex">lex</primary></indexterm> </listitem> diff --git a/chapter06/gettext.xml b/chapter06/gettext.xml index a0976b514..1ff20a908 100644 --- a/chapter06/gettext.xml +++ b/chapter06/gettext.xml @@ -196,7 +196,7 @@ to the given <filename class="extension">.po</filename> files</para> <varlistentry id="msgfmt"> <term><command>msgfmt</command></term> <listitem> -<para>Generates a binary message catalog from from a translation catalog</para> +<para>Generates a binary message catalog from a translation catalog</para> <indexterm zone="ch-system-gettext msgfmt"><primary sortas="b-msgfmt">msgfmt</primary></indexterm> </listitem> </varlistentry> diff --git a/chapter06/groff.xml b/chapter06/groff.xml index c518fb937..c413cae8b 100644 --- a/chapter06/groff.xml +++ b/chapter06/groff.xml @@ -106,7 +106,7 @@ within troff input files into commands that are understood by <command>troff</co </varlistentry> <varlistentry id="geqn"> -<term><command>eqn</command></term> +<term><command>geqn</command></term> <listitem> <para>A link to <command>eqn</command></para> <indexterm zone="ch-system-groff geqn"><primary sortas="b-geqn">geqn</primary></indexterm> @@ -198,7 +198,7 @@ a form suitable for typewriter-like devices</para> <varlistentry id="gtbl"> <term><command>gtbl</command></term> <listitem> -<para>Is the GNU implementation of <command>tbl</command></para> +<para>A link to <command>tbl</command></para> <indexterm zone="ch-system-groff gtbl"><primary sortas="b-gtbl">gtbl</primary></indexterm> </listitem> </varlistentry> @@ -362,7 +362,7 @@ appropriate order and with the appropriate options</para> <varlistentry id="zsoelim"> <term><command>zsoelim</command></term> <listitem> -<para>Is the GNU implementation of <command>soelim</command></para> +<para>A link to <command>soelim</command></para> <indexterm zone="ch-system-groff zsoelim"><primary sortas="b-zsoelim">zsoelim</primary></indexterm> </listitem> </varlistentry> diff --git a/chapter06/gzip.xml b/chapter06/gzip.xml index 4a99c251f..c0347e5b8 100644 --- a/chapter06/gzip.xml +++ b/chapter06/gzip.xml @@ -85,7 +85,7 @@ zegrep, zfgrep, zforce, zgrep, zless, zmore, and znew</seg></seglistitem> <varlistentry id="compress"> <term><command>compress</command></term> <listitem> -<para>Compresses and uncompresses compressed files</para> +<para>Compresses and decompresses files</para> <indexterm zone="ch-system-gzip compress"><primary sortas="b-compress">compress</primary></indexterm> </listitem> </varlistentry> @@ -101,7 +101,7 @@ zegrep, zfgrep, zforce, zgrep, zless, zmore, and znew</seg></seglistitem> <varlistentry id="gzexe"> <term><command>gzexe</command></term> <listitem> -<para>Creates self-uncompressing executable files</para> +<para>Creates self-decompressing executable files</para> <indexterm zone="ch-system-gzip gzexe"><primary sortas="b-gzexe">gzexe</primary></indexterm> </listitem> </varlistentry> diff --git a/chapter06/hotplug.xml b/chapter06/hotplug.xml index 6832fda2c..eccb9de52 100644 --- a/chapter06/hotplug.xml +++ b/chapter06/hotplug.xml @@ -47,7 +47,7 @@ using the script included with LFS-Bootscripts:</para> <screen><userinput>rm -rf /etc/init.d</userinput></screen> -<para>Network device hotplugging is not supported by LFS bootscripts yet. For +<para>Network device hotplugging is not supported by LFS-Bootscripts yet. For that reason, remove the network hotplug agent:</para> <screen><userinput>rm -f /etc/hotplug/net.agent</userinput></screen> diff --git a/chapter06/iana-etc.xml b/chapter06/iana-etc.xml index 856ff2f21..556c9c55a 100644 --- a/chapter06/iana-etc.xml +++ b/chapter06/iana-etc.xml @@ -29,7 +29,9 @@ <sect2 role="installation"> <title>Installation of Iana-Etc -Parse the data: +The following command converts the raw data provided by IANA into the +correct formats for the /etc/protocols and +/etc/services data files: make diff --git a/chapter06/iproute2.xml b/chapter06/iproute2.xml index bf79aced1..20701c0e5 100644 --- a/chapter06/iproute2.xml +++ b/chapter06/iproute2.xml @@ -113,7 +113,7 @@ Shows the interface statistics, including the amount of transmitted - and received packages by interface + and received packets by interface ifstat diff --git a/chapter06/kbd.xml b/chapter06/kbd.xml index 511e465b6..70a5980fe 100644 --- a/chapter06/kbd.xml +++ b/chapter06/kbd.xml @@ -103,7 +103,7 @@ showconsolefont, showkey, unicode_start, and unicode_stop getunimap -Prints the currently used unimap +Prints the currently used unicode-to-font mapping table getunimap diff --git a/chapter06/man.xml b/chapter06/man.xml index ad40e1186..4caa3ad8f 100644 --- a/chapter06/man.xml +++ b/chapter06/man.xml @@ -68,15 +68,17 @@ class="directory">/etc directory. make install -To disable Select Graphic Rendition (SGR) escape -sequences, edit the man.conf file and -add the -c switch to -the NROFF variable. +If you will be working on a terminal that does not support text +attributes such as color and bold, you can disable Select Graphic Rendition +(SGR) escape sequences by editing the man.conf file and +adding the -c option to the NROFF +variable. If you use multiple terminal types for one computer it may be better +to selectively add the GROFF_NO_SGR environment variable for the +terminals that do not support SGR. -If the character set uses 8-bit characters, search for the line -beginning with NROFF in -/etc/man.conf, and verify that it looks as -follows: +If the character set of the locale uses 8-bit characters, search for the +line beginning with NROFF in /etc/man.conf, +and verify that it looks as follows: NROFF /usr/bin/nroff -Tlatin1 -mandoc diff --git a/chapter06/module-init-tools.xml b/chapter06/module-init-tools.xml index 82fecbef3..3d990f214 100644 --- a/chapter06/module-init-tools.xml +++ b/chapter06/module-init-tools.xml @@ -42,6 +42,16 @@ installed in LFS. Run the following command to avoid this: ./configure --prefix="" --enable-zlib +The meaning of the configure options: + + + +--enable-zlib +This allows the Module-Init-Tools package to handle compressed +kernel modules. + + + Compile the package: make diff --git a/chapter06/ncurses.xml b/chapter06/ncurses.xml index 38153e3eb..33ff5341d 100644 --- a/chapter06/ncurses.xml +++ b/chapter06/ncurses.xml @@ -58,7 +58,7 @@ where they are expected to reside: mv /usr/lib/libncurses.so.5* /lib -Because the libraries have been moved, a few symlinks are pointing to +Because the libraries have been moved, a few symlinks point to non-existent files. Recreate those symlinks: ln -sf ../../lib/libncurses.so.5 /usr/lib/libncurses.so diff --git a/chapter06/perl.xml b/chapter06/perl.xml index aa90509e7..3d8188561 100644 --- a/chapter06/perl.xml +++ b/chapter06/perl.xml @@ -52,8 +52,8 @@ of the less program. make To run the test suite, first create a basic -/etc/hosts file which is needed by a couple of -tests to resolve the network name localhost: +/etc/hosts file which is needed by a couple of the tests to +resolve the network name localhost: echo "127.0.0.1 localhost $(hostname)" > /etc/hosts diff --git a/chapter06/psmisc.xml b/chapter06/psmisc.xml index 5b8b20f34..f430462d5 100644 --- a/chapter06/psmisc.xml +++ b/chapter06/psmisc.xml @@ -12,8 +12,8 @@ Psmisc -<para>The Psmisc package contains programs for displaying information on -processes.</para> +<para>The Psmisc package contains programs for displaying information about +running processes.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> diff --git a/chapter06/readline.xml b/chapter06/readline.xml index 40f0bd53b..f3180a46d 100644 --- a/chapter06/readline.xml +++ b/chapter06/readline.xml @@ -12,7 +12,8 @@ <indexterm zone="ch-system-readline"><primary sortas="a-Readline">Readline</primary></indexterm> <sect2 role="package"><title/> -<para>The Readline package contains the Readline command-line library.</para> +<para>The Readline package is a set of libraries that offers command-line +editing and history capabilities.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> @@ -30,10 +31,9 @@ GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> <sect2 role="installation"> <title>Installation of Readline -The following patch includes a fix for the problem where -Readline sometimes only shows 33 characters on a line and then wraps -to the next line. It also includes other fixes recommended by the -Readline author. +The following patch includes a fix for a problem where Readline sometimes +only shows 33 characters on a line and then wraps to the next line. It also +includes other fixes recommended by the Readline author. patch -Np1 -i ../&readline-fixes-patch; @@ -63,14 +63,13 @@ Readline author. chmod 755 /lib/lib{readline,history}.so* -Now we move the static libraries to a more appropriate -location: +Now move the static libraries to a more appropriate location: mv /lib/lib{readline,history}.a /usr/lib -Next we will remove the .so files in -/lib and relink them into -/usr/lib. +Next, remove the .so files in +/lib and relink them into /usr/lib. rm /lib/lib{readline,history}.so ln -sf ../../lib/libreadline.so.5 /usr/lib/libreadline.so diff --git a/chapter06/shadow.xml b/chapter06/shadow.xml index 094ccbed4..8e62fefa6 100644 --- a/chapter06/shadow.xml +++ b/chapter06/shadow.xml @@ -50,7 +50,8 @@ sed -i '/groups/d' man/Makefile make install Shadow uses two files to configure -authentication settings for the system. Install these two config files: +authentication settings for the system. Install these two configuration +files: /etc/limits /etc/login.access @@ -164,7 +165,7 @@ password changes chfn -Used to change a user's full name and other info +Used to change a user's full name and other information chfn diff --git a/chapter06/vim.xml b/chapter06/vim.xml index 073d0a5a4..2accc832d 100644 --- a/chapter06/vim.xml +++ b/chapter06/vim.xml @@ -69,11 +69,10 @@ Core that use UTF-8 as a default character set. make -To test the results, issue: -make test. However, this test suite outputs a -lot of chaotic characters to the screen, which can cause issues with -the settings of the current terminal. Therefore, running the test -suite here is optional. +To test the results, issue: make test. However, +this test suite outputs a lot of binary data to the screen, which can cause +issues with the settings of the current terminal. This can be resolved by +redirecting the output to a log file. Install the package: @@ -99,13 +98,13 @@ url="&blfs-root;view/svn/postlfs/editors.html#postlfs-editors-vim"/>. Configuring Vim /etc/vim -By default, vim runs in vi-incompatible mode. -This may be new to users who have used other editors in the past. The -nocompatible setting is included below to highlight the -fact that a new behavior is being used. It also reminds those who -would change to compatible mode that it should appear -first. This is necessary because it changes other settings, and -overrides must come after this setting. Create a default vim +By default, vim runs in vi-incompatible mode. This may +be new to users who have used other editors in the past. The +nocompatible setting is included below to highlight the fact that +a new behavior is being used. It also reminds those who would change to +compatible mode that it should be the first setting in the +configuration file. This is necessary because it changes other settings, and +overrides must come after this setting. Create a default vim configuration file by running the following: cat > /etc/vimrc << "EOF" @@ -233,7 +232,7 @@ commands can be started and vim cannot be suspended shtags.pl -Generates a tag file for Perl scripts +Generates a tags file for Perl scripts shtags.pl @@ -241,7 +240,7 @@ commands can be started and vim cannot be suspended tcltags -Generates a tag file for TCL code +Generates a tags file for TCL code tcltags @@ -305,9 +304,10 @@ commands can be started and vim cannot be suspended vimspell.sh -Spells a file and generates the syntax statements necessary -to highlight in vim. This script requires the old Unix spell -command, which is provided neither in LFS nor in BLFS +Spell checks a file and generates the syntax statements necessary to +highlight in vim. This script requires the old Unix +spell command, which is provided neither in LFS nor in +BLFS vimspell.sh diff --git a/chapter06/zlib.xml b/chapter06/zlib.xml index 93c21e44a..0c9fa8abc 100644 --- a/chapter06/zlib.xml +++ b/chapter06/zlib.xml @@ -12,7 +12,7 @@ Zlib -<para>The Zlib package contains compression and un-compression routines used by +<para>The Zlib package contains compression and decompression routines used by some programs.</para> <segmentedlist>