diff --git a/chapter06/coreutils.xml b/chapter06/coreutils.xml index 602643a80..0ee96e0ff 100644 --- a/chapter06/coreutils.xml +++ b/chapter06/coreutils.xml @@ -36,7 +36,7 @@ fixes this behavior for Intel architectures: patch -Np1 -i ../coreutils-&coreutils-version;-uname-2.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 \ @@ -50,10 +50,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 46c9cd42a..266612547 100644 --- a/chapter06/e2fsprogs.xml +++ b/chapter06/e2fsprogs.xml @@ -50,15 +50,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. -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 90ac8092a..5f3948bf2 100644 --- a/chapter06/file.xml +++ b/chapter06/file.xml @@ -10,7 +10,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 388ef5441..2290d4f3c 100644 --- a/chapter06/findutils.xml +++ b/chapter06/findutils.xml @@ -36,7 +36,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 fcf54c791..e56ebc776 100644 --- a/chapter06/flex.xml +++ b/chapter06/flex.xml @@ -115,7 +115,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 1dcaa4024..001b40dc3 100644 --- a/chapter06/gettext.xml +++ b/chapter06/gettext.xml @@ -194,7 +194,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 473610e26..d6d9fc482 100644 --- a/chapter06/groff.xml +++ b/chapter06/groff.xml @@ -104,7 +104,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> @@ -196,7 +196,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> @@ -360,7 +360,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 75d86b1f7..4a6cef7ef 100644 --- a/chapter06/gzip.xml +++ b/chapter06/gzip.xml @@ -83,7 +83,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> @@ -99,7 +99,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 349f1fd56..516645464 100644 --- a/chapter06/hotplug.xml +++ b/chapter06/hotplug.xml @@ -45,7 +45,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 9b2ed104e..32c169c23 100644 --- a/chapter06/iana-etc.xml +++ b/chapter06/iana-etc.xml @@ -27,7 +27,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 6d545c21b..ef957cda8 100644 --- a/chapter06/iproute2.xml +++ b/chapter06/iproute2.xml @@ -111,7 +111,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 0b86b6a3e..5bda6f6de 100644 --- a/chapter06/kbd.xml +++ b/chapter06/kbd.xml @@ -101,7 +101,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 75ce4c7dd..526c751c4 100644 --- a/chapter06/man.xml +++ b/chapter06/man.xml @@ -66,15 +66,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 885c753ba..88195a62e 100644 --- a/chapter06/module-init-tools.xml +++ b/chapter06/module-init-tools.xml @@ -40,6 +40,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 15c2b717f..57139de47 100644 --- a/chapter06/ncurses.xml +++ b/chapter06/ncurses.xml @@ -56,7 +56,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 560722dff..d969c44e3 100644 --- a/chapter06/perl.xml +++ b/chapter06/perl.xml @@ -50,8 +50,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 c6bca8831..ba7c627da 100644 --- a/chapter06/psmisc.xml +++ b/chapter06/psmisc.xml @@ -10,8 +10,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 6c5bc73cb..a33acc6eb 100644 --- a/chapter06/readline.xml +++ b/chapter06/readline.xml @@ -10,7 +10,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> @@ -28,10 +29,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-&readline-version;-fixes-1.patch @@ -61,14 +61,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 b1b96411b..a6b116c08 100644 --- a/chapter06/shadow.xml +++ b/chapter06/shadow.xml @@ -48,7 +48,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 808d223ad..e4d6ea543 100644 --- a/chapter06/vim.xml +++ b/chapter06/vim.xml @@ -67,11 +67,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: @@ -97,13 +96,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" @@ -231,7 +230,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 @@ -239,7 +238,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 @@ -303,9 +302,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 d47a4da16..55e0a9c46 100644 --- a/chapter06/zlib.xml +++ b/chapter06/zlib.xml @@ -10,7 +10,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>