diff --git a/chapter08/coreutils.xml b/chapter08/coreutils.xml index 34a41163e..77c6a7a92 100644 --- a/chapter08/coreutils.xml +++ b/chapter08/coreutils.xml @@ -363,7 +363,7 @@ sed -i 's/"1"/"8"/' /usr/share/man/man8/chroot.8 date - Displays the current dae and time in the given format, or sets the + Displays the current date and time in the given format, or sets the system date and time date diff --git a/chapter08/diffutils.xml b/chapter08/diffutils.xml index 8889077d5..2ffb9fa8c 100644 --- a/chapter08/diffutils.xml +++ b/chapter08/diffutils.xml @@ -79,8 +79,7 @@ cmp - Compares two files and reports whether or in which bytes they - differ + Compares two files and reports any differences byte by byte cmp diff --git a/chapter08/findutils.xml b/chapter08/findutils.xml index 092be0c96..bf93ed35e 100644 --- a/chapter08/findutils.xml +++ b/chapter08/findutils.xml @@ -23,10 +23,12 @@ - <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> @@ -53,9 +55,9 @@ <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> diff --git a/chapter08/groff.xml b/chapter08/groff.xml index 64739ac67..e5ae875f3 100644 --- a/chapter08/groff.xml +++ b/chapter08/groff.xml @@ -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"> diff --git a/chapter08/grub.xml b/chapter08/grub.xml index 3cba0dc9c..4979f21e1 100644 --- a/chapter08/grub.xml +++ b/chapter08/grub.xml @@ -52,12 +52,12 @@ content of this page and try to figure out how to boot your system. </para> <para> - If your system firmware supports UEFI and you want a fully - functional GRUB, you can skip the content of this page, - and install GRUB with UEFI support (and its dependencies) following + 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) by following + the instructions on <ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink> - (with <parameter>--target=x86_64</parameter> removed) at the end of - this chapter. + (with <parameter>--target=x86_64</parameter> removed). </para> </note> @@ -67,9 +67,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> @@ -86,7 +86,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> @@ -94,7 +94,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> @@ -113,7 +113,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> @@ -149,7 +149,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> @@ -159,7 +159,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> @@ -169,7 +169,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> @@ -179,7 +179,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> @@ -189,7 +189,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> @@ -199,7 +199,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> @@ -209,7 +209,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> @@ -220,7 +220,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> @@ -241,7 +242,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> @@ -251,7 +252,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> @@ -302,7 +303,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> @@ -322,7 +324,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> @@ -332,7 +334,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> @@ -352,7 +354,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> @@ -362,7 +364,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> @@ -392,7 +394,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> diff --git a/chapter08/iproute2.xml b/chapter08/iproute2.xml index 25e7e81be..878ae22ed 100644 --- a/chapter08/iproute2.xml +++ b/chapter08/iproute2.xml @@ -42,12 +42,12 @@ <title>Installation of IPRoute2 The arpd 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 arpd and a man page will still - be installed. Prevent this by running the commands below. - If the arpd binary is needed, - instructions for compiling Berkeley DB can be found in the BLFS Book at - . + be built since it depends on Berkeley DB, which is not installed in + LFS. However, a directory and a man page for arpd will still + be installed. Prevent this by running the commands shown below. + (If the arpd program is needed, + instructions for compiling Berkeley DB can be found in the BLFS book at + .) sed -i /ARPD/d Makefile @@ -93,8 +93,8 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version;Installed directories - bridge, ctstat (link to lnstat), genl, ifcfg, ifstat, ip, lnstat, - nstat, routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss, + bridge, ctstat (link to lnstat), genl, ifstat, ip, lnstat, + nstat, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss, and tc /etc/iproute2, /usr/lib/tc, and /usr/share/doc/iproute2-&iproute2-version; @@ -129,31 +129,18 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version; genl - Generic netlink utility frontend + Generic netlink utility front end genl - - ifcfg - - A shell script wrapper for the ip command - [Note that it requires the arping and - rdisk programs from the - iputils package found at .] - - ifcfg - - - - ifstat - Shows the interface statistics, including the amount of - transmitted and received packets by interface + Shows interface statistics, including the number of + packets transmitted and received, by interface ifstat @@ -163,7 +150,7 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version; ip - The main executable. It has several different functions: + The main executable. It has several different functions, including these: ip link <device> allows users to look at the state of devices and to make changes @@ -213,28 +200,17 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version; nstat - Shows network statistics + Displays network statistics nstat - - routef - - A component of ip route. This is for flushing - the routing tables - - routef - - - - routel - A component of ip route. This is for listing + A component of ip route, for listing the routing tables routel @@ -266,7 +242,7 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version; rtpr - Converts the output of ip -o back into a + Converts the output of ip -o into a readable form rtpr @@ -295,25 +271,26 @@ cp -v COPYING README* /usr/share/doc/iproute2-&iproute2-version; + tc - Traffic Controlling Executable; this is for Quality Of Service - (QOS) and Class Of Service (COS) implementations + Traffic control for Quality of Service + (QoS) and Class of Service (CoS) implementations - tc qdisc allows users to setup the queueing + tc qdisc allows users to set up the queueing discipline - tc class allows users to setup classes based + tc class allows users to set up classes based on the queuing discipline scheduling tc estimator allows users to estimate the - network flow into a network + data flow through a network - tc filter allows users to setup the QOS/COS + tc filter allows users to set up the QoS/CoS packet filtering - tc policy allows users to setup the QOS/COS + tc policy allows users to set up the QoS/CoS policies tc diff --git a/chapter08/m4.xml b/chapter08/m4.xml index 13b032a25..14ce93291 100644 --- a/chapter08/m4.xml +++ b/chapter08/m4.xml @@ -89,7 +89,7 @@ echo "#define _IO_IN_BACKUP 0x100" >> lib/stdio-impl.h m4 has built-in functions for including named files, running Unix commands, performing integer arithmetic, manipulating text, recursion, etc. The m4 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 m4