From 11bc6d562fad951d5a14e6374b2355983ee9282a Mon Sep 17 00:00:00 2001 From: Manuel Canales Esparcia Date: Tue, 1 Aug 2006 06:27:35 +0000 Subject: Finished the PDF fixes. git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/6.2/BOOK@7737 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- appendices/acknowledgments.xml | 2 ++ appendices/dependencies.xml | 16 ++++++++++++++++ chapter01/askforhelp.xml | 2 ++ chapter03/packages.xml | 6 ++++++ chapter04/settingenviron.xml | 2 ++ chapter05/adjusting.xml | 8 ++++---- chapter05/binutils-pass1.xml | 2 ++ chapter05/gcc-pass2.xml | 2 ++ chapter05/glibc.xml | 1 + chapter05/tcl.xml | 2 ++ chapter06/automake.xml | 1 + chapter06/binutils.xml | 2 ++ chapter06/bzip2.xml | 2 ++ chapter06/coreutils.xml | 2 ++ chapter06/createfiles.xml | 2 ++ chapter06/gcc.xml | 6 ++++++ chapter06/glibc.xml | 11 +++++++++-- chapter06/groff.xml | 2 ++ chapter06/iproute2.xml | 2 ++ chapter06/kbd.xml | 5 ++--- chapter06/man-db.xml | 1 + chapter06/perl.xml | 2 ++ chapter06/pkgmgt.xml | 4 ++++ chapter06/readjusting.xml | 2 ++ chapter06/readline.xml | 2 ++ chapter06/sysklogd.xml | 2 ++ chapter06/texinfo.xml | 2 ++ chapter06/util-linux.xml | 2 ++ chapter06/zlib.xml | 2 ++ chapter07/network.xml | 4 ++++ chapter07/profile.xml | 2 ++ chapter07/udev.xml | 18 ++++++++++++------ chapter08/fstab.xml | 12 ++++++++---- chapter08/kernel.xml | 5 ++++- prologue/hostreqs.xml | 2 ++ prologue/prerequisites.xml | 12 ++++++------ prologue/typography.xml | 2 +- stylesheets/pdf/lfs-pagesetup.xsl | 5 +++++ 38 files changed, 132 insertions(+), 27 deletions(-) diff --git a/appendices/acknowledgments.xml b/appendices/acknowledgments.xml index 4be9b8a68..61ceb0bab 100644 --- a/appendices/acknowledgments.xml +++ b/appendices/acknowledgments.xml @@ -293,6 +293,8 @@ + + Australian Mirrors diff --git a/appendices/dependencies.xml b/appendices/dependencies.xml index cf5a1ac84..59ebea19f 100644 --- a/appendices/dependencies.xml +++ b/appendices/dependencies.xml @@ -143,6 +143,8 @@ + + Binutils @@ -310,6 +312,8 @@ + + Expect @@ -478,6 +482,8 @@ + + Gcc @@ -646,6 +652,8 @@ + + Gzip @@ -813,6 +821,8 @@ + + Libtool @@ -979,6 +989,8 @@ + + Module-Init-Tools @@ -1146,6 +1158,8 @@ + + Readline @@ -1312,6 +1326,8 @@ + + Tcl diff --git a/chapter01/askforhelp.xml b/chapter01/askforhelp.xml index 6b662cc6b..77f8084d8 100644 --- a/chapter01/askforhelp.xml +++ b/chapter01/askforhelp.xml @@ -72,6 +72,8 @@ not printed to the screen. Include the relevant lines if you need to ask for help. + + diff --git a/chapter03/packages.xml b/chapter03/packages.xml index db5770aa4..80fe80d02 100644 --- a/chapter03/packages.xml +++ b/chapter03/packages.xml @@ -92,6 +92,7 @@ Home page: Download: MD5 sum: &coreutils-md5; + @@ -173,6 +174,7 @@ Home page: Download: MD5 sum: &gawk-md5; + @@ -263,6 +265,7 @@ Home page: Download: MD5 sum: &inetutils-md5; + @@ -351,6 +354,7 @@ Home page: Download: MD5 sum: &make-md5; + @@ -457,6 +461,7 @@ Home page: Download: MD5 sum: &readline-md5; + @@ -547,6 +552,7 @@ Home page: Download: MD5 sum: &udev-config-md5; + diff --git a/chapter04/settingenviron.xml b/chapter04/settingenviron.xml index 561e30381..239b265d5 100644 --- a/chapter04/settingenviron.xml +++ b/chapter04/settingenviron.xml @@ -83,6 +83,8 @@ EOF that old programs are used from the host when the same programs are available in the chapter 5 environment. + + Finally, to have the environment fully prepared for building the temporary tools, source the just-created user profile: diff --git a/chapter05/adjusting.xml b/chapter05/adjusting.xml index a3d1e9d14..be5a1b15c 100644 --- a/chapter05/adjusting.xml +++ b/chapter05/adjusting.xml @@ -41,8 +41,8 @@ sed 's@^/lib/ld-linux.so.2@/tools&@g' $SPECFILE > tempspecfile && mv -vf tempspecfile $SPECFILE && unset SPECFILE - It is recommended that the above command be copy-and-pasted in order to - ensure accuracy. Alternatively, the specs file can be edited by hand. This is + It is recommended that the above command be copy-and-pasted in order to + ensure accuracy. Alternatively, the specs file can be edited by hand. This is done by replacing every occurrence of /lib/ld-linux.so.2 with /tools/lib/ld-linux.so.2 @@ -67,9 +67,9 @@ unset SPECFILE which have both been installed at this point, any fixed headers can safely be removed. This helps to avoid any host headers polluting the build environment. Run the following commands to remove the - header files in GCC's private include directory (you may find it easier to + header files in GCC's private include directory (you may find it easier to copy and paste these commands, rather than typing them by hand, due to - their length): + their length): GCC_INCLUDEDIR=`dirname $(gcc -print-libgcc-file-name)`/include && diff --git a/chapter05/binutils-pass1.xml b/chapter05/binutils-pass1.xml index 3541aa055..f42bd1716 100644 --- a/chapter05/binutils-pass1.xml +++ b/chapter05/binutils-pass1.xml @@ -97,6 +97,8 @@ cd ../binutils-build make install + + Next, prepare the linker for the Adjusting phase later on: diff --git a/chapter05/gcc-pass2.xml b/chapter05/gcc-pass2.xml index 7fc0bb49b..5510bf554 100644 --- a/chapter05/gcc-pass2.xml +++ b/chapter05/gcc-pass2.xml @@ -90,6 +90,8 @@ sed 's/^XCFLAGS =$/& -fomit-frame-pointer/' gcc/Makefile.in.tmp \ patch -Np1 -i ../&gcc-specs-patch; + + The above patch also removes /usr/include from GCC's include search path. Patching now rather than adjusting the specs file after installation diff --git a/chapter05/glibc.xml b/chapter05/glibc.xml index a251b0e86..598c391e0 100644 --- a/chapter05/glibc.xml +++ b/chapter05/glibc.xml @@ -102,6 +102,7 @@ cd ../glibc-build This tells Glibc to compile itself against the headers recently installed to the tools directory, so that it knows exactly what features the kernel has and can optimize itself accordingly. + diff --git a/chapter05/tcl.xml b/chapter05/tcl.xml index aa56ceff4..1659cbbd2 100644 --- a/chapter05/tcl.xml +++ b/chapter05/tcl.xml @@ -74,6 +74,8 @@ ln -sv tclsh8.4 /tools/bin/tclsh + + diff --git a/chapter06/automake.xml b/chapter06/automake.xml index 65da0b897..0af737ea3 100644 --- a/chapter06/automake.xml +++ b/chapter06/automake.xml @@ -159,6 +159,7 @@ config.sub + diff --git a/chapter06/binutils.xml b/chapter06/binutils.xml index 5c9514bf2..7c6782aac 100644 --- a/chapter06/binutils.xml +++ b/chapter06/binutils.xml @@ -87,6 +87,8 @@ cd ../binutils-build + + The test suite for Binutils in this section is considered critical. Do not skip it under any circumstances. diff --git a/chapter06/bzip2.xml b/chapter06/bzip2.xml index 69d4d9b12..75ffd6262 100644 --- a/chapter06/bzip2.xml +++ b/chapter06/bzip2.xml @@ -87,6 +87,8 @@ make clean make install + + Install the shared bzip2 binary into the /bin directory, make some necessary symbolic links, and clean up: diff --git a/chapter06/coreutils.xml b/chapter06/coreutils.xml index bc614c205..b537359eb 100644 --- a/chapter06/coreutils.xml +++ b/chapter06/coreutils.xml @@ -83,6 +83,8 @@ 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: echo "dummy1:x:1000:" >> /etc/group diff --git a/chapter06/createfiles.xml b/chapter06/createfiles.xml index 0cfc7596f..ece397b66 100644 --- a/chapter06/createfiles.xml +++ b/chapter06/createfiles.xml @@ -89,6 +89,8 @@ usb:x:14: cdrom:x:15: EOF + + The created groups are not part of any standard—they are groups decided on in part by the requirements of the Udev configuration in this chapter, and in part by common convention employed by a number of existing diff --git a/chapter06/gcc.xml b/chapter06/gcc.xml index 41754d817..fc2cd01a6 100644 --- a/chapter06/gcc.xml +++ b/chapter06/gcc.xml @@ -83,6 +83,8 @@ cd ../gcc-build make + + In this section, the test suite for GCC is considered critical. Do not skip it under any circumstance. @@ -149,6 +151,8 @@ cd ../gcc-build href="readjusting.xml" xpointer="xpointer(//*[@os='e'])"/> + + @@ -218,6 +222,8 @@ SEARCH_DIR("/usr/lib"); href="readjusting.xml" xpointer="xpointer(//*[@os='t'])"/> + + diff --git a/chapter06/glibc.xml b/chapter06/glibc.xml index eb6d8d080..798b4cf4b 100644 --- a/chapter06/glibc.xml +++ b/chapter06/glibc.xml @@ -57,8 +57,8 @@ The glibc-libidn tarball adds support for internationalized domain names (IDN) to Glibc. Many programs that support IDN require the full - libidn library (see - ), not this add-on. + libidn library, not this add-on (see + ). Unpack the tarball from within the Glibc source directory: tar -xf ../glibc-libidn-&glibc-version;.tar.bz2 @@ -87,6 +87,8 @@ 's|libs -o|libs -L/usr/lib -Wl,-dynamic-linker=/lib/ld-linux.so.2 -o|' \ scripts/test-installation.pl + + The Glibc documentation recommends building Glibc outside of the source directory in a dedicated build directory: @@ -233,6 +235,8 @@ localedef -i ja_JP -f EUC-JP ja_JP the Glibc defaults do not work well in a networked environment. The time zone also needs to be configured. + + Create a new file /etc/nsswitch.conf by running the following: @@ -315,6 +319,8 @@ EOF class="directory">/opt/lib, so add those directories to the dynamic loader's search path. + + Create a new file /etc/ld.so.conf by running the following: @@ -510,6 +516,7 @@ EOF pcprofiledump + diff --git a/chapter06/groff.xml b/chapter06/groff.xml index 3887ca4c0..93dc1dcdf 100644 --- a/chapter06/groff.xml +++ b/chapter06/groff.xml @@ -81,6 +81,8 @@ ln -sv eqn /usr/bin/geqn ln -sv tbl /usr/bin/gtbl + + diff --git a/chapter06/iproute2.xml b/chapter06/iproute2.xml index eb0438e25..abd79d447 100644 --- a/chapter06/iproute2.xml +++ b/chapter06/iproute2.xml @@ -139,6 +139,8 @@ ip link <device> allows users to look at the state of devices and to make changes + + ip addr allows users to look at addresses and their properties, add new addresses, and delete old ones diff --git a/chapter06/kbd.xml b/chapter06/kbd.xml index 1ada7b17c..fcdb7a89a 100644 --- a/chapter06/kbd.xml +++ b/chapter06/kbd.xml @@ -83,6 +83,8 @@ such languages have to download working keymaps separately. + + Some of the scripts in the LFS-Bootscripts package depend on kbd_mode, openvt, and setfont. As /usr @@ -91,9 +93,6 @@ mv -v /usr/bin/{kbd_mode,openvt,setfont} /bin - - - diff --git a/chapter06/man-db.xml b/chapter06/man-db.xml index 482ae7a17..2f0bd2f8d 100644 --- a/chapter06/man-db.xml +++ b/chapter06/man-db.xml @@ -86,6 +86,7 @@ EOF This tells the man program to use the ascii8 and nippon Groff devices for formatting non-ISO-8859-1 manual pages. + diff --git a/chapter06/perl.xml b/chapter06/perl.xml index 50efc833a..04e586ac9 100644 --- a/chapter06/perl.xml +++ b/chapter06/perl.xml @@ -85,6 +85,8 @@ make install + + diff --git a/chapter06/pkgmgt.xml b/chapter06/pkgmgt.xml index c5c783b92..f145caf3f 100644 --- a/chapter06/pkgmgt.xml +++ b/chapter06/pkgmgt.xml @@ -87,6 +87,8 @@ making a decision on a package manager, do some research on the various techniques, particularly the drawbacks of the particular scheme. + + It is All in My Head! @@ -161,6 +163,8 @@ make DESTDIR=/usr/pkg/libfoo/1.1 install package, or you may find that it is easier to install some problematic packages into /opt. + + diff --git a/chapter06/readjusting.xml b/chapter06/readjusting.xml index 3107168fa..55c8537d6 100644 --- a/chapter06/readjusting.xml +++ b/chapter06/readjusting.xml @@ -73,6 +73,8 @@ readelf -l a.out | grep ': /lib' grep -o '/usr/lib.*/crt[1in].* .*' dummy.log + + If everything is working correctly, there should be no errors, and the output of the last command will be: diff --git a/chapter06/readline.xml b/chapter06/readline.xml index 39ea3a3b6..e347daf39 100644 --- a/chapter06/readline.xml +++ b/chapter06/readline.xml @@ -84,6 +84,8 @@ sed -i '/{OLDSUFF}/c:' support/shlib-install mv -v /lib/lib{readline,history}.a /usr/lib + + Next, remove the .so files in /lib and relink them into /usr/lib: diff --git a/chapter06/sysklogd.xml b/chapter06/sysklogd.xml index 87ec2e842..76abbb8f6 100644 --- a/chapter06/sysklogd.xml +++ b/chapter06/sysklogd.xml @@ -87,6 +87,8 @@ user.* -/var/log/user.log # End /etc/syslog.conf EOF + + diff --git a/chapter06/texinfo.xml b/chapter06/texinfo.xml index 761c4c5e7..91f1e6f05 100644 --- a/chapter06/texinfo.xml +++ b/chapter06/texinfo.xml @@ -90,6 +90,8 @@ If the /usr/share/info/dir file ever needs to be recreated, the following optional commands will accomplish the task: + + cd /usr/share/info rm dir for f in * diff --git a/chapter06/util-linux.xml b/chapter06/util-linux.xml index 900c89e40..602e9298c 100644 --- a/chapter06/util-linux.xml +++ b/chapter06/util-linux.xml @@ -93,6 +93,8 @@ mkdir -p /var/lib/hwclock make HAVE_KILL=yes HAVE_SLN=yes install + + diff --git a/chapter06/zlib.xml b/chapter06/zlib.xml index b5bca5e1c..db96d1112 100644 --- a/chapter06/zlib.xml +++ b/chapter06/zlib.xml @@ -84,6 +84,8 @@ make chmod -v 644 /usr/lib/libz.a + + diff --git a/chapter07/network.xml b/chapter07/network.xml index 6462aa16b..e3d227e15 100644 --- a/chapter07/network.xml +++ b/chapter07/network.xml @@ -75,6 +75,8 @@ ACTION=="add", SUBSYSTEM=="net", BUS=="pci", ID==" EOF + + These rules will always rename the network cards to realtek and intel, independently of the original numbering provided by the kernel (i.e.: the original @@ -150,6 +152,8 @@ EOF Dynamic Host Configuration Protocol (DHCP), which is addressed in the BLFS book. + + The GATEWAY variable should contain the default gateway IP address, if one is present. If not, then comment out the variable entirely. diff --git a/chapter07/profile.xml b/chapter07/profile.xml index 5f6483133..ebfb8b755 100644 --- a/chapter07/profile.xml +++ b/chapter07/profile.xml @@ -160,6 +160,8 @@ EOF 8-bit). So you can use the C locale only if you are sure that you will never need 8-bit characters. + + UTF-8 based locales are not supported well by many programs. E.g., the watch program displays only ASCII characters in UTF-8 locales and has no such restriction in traditional 8-bit locales like en_US. diff --git a/chapter07/udev.xml b/chapter07/udev.xml index 61bd71cc7..51be13b3a 100644 --- a/chapter07/udev.xml +++ b/chapter07/udev.xml @@ -89,6 +89,8 @@ available to userspace processes and to udevd for device node creation. + + @@ -180,6 +182,8 @@ generates a uevent. This uevent is then handled by udevd as described above. + + @@ -259,6 +263,8 @@ Blacklisted modules can still be loaded manually with the explicit modprobe command. + + @@ -331,18 +337,18 @@ - A Userspace Implementation of devfs - + A Userspace Implementation of devfs + - udev FAQ - + udev FAQ + - The sysfs Filesystem - + The sysfs Filesystem + diff --git a/chapter08/fstab.xml b/chapter08/fstab.xml index 2c1b056f3..8c4b7bf2f 100644 --- a/chapter08/fstab.xml +++ b/chapter08/fstab.xml @@ -74,14 +74,18 @@ EOF /dev/sda1 /media/flash vfat noauto,user,quiet,showexec,iocharset=utf8,codepage=866 0 0 - In the latter case, the kernel emits the following message: + + + + In the latter case, the kernel emits the following message: FAT: utf8 is not a recommended IO charset for FAT filesystems, filesystem will be case sensitive! - This negative recommendation should be ignored, since all other values - of the iocharset option result in wrong display of filenames in - UTF-8 locales. + This negative recommendation should be ignored, since all other values + of the iocharset option result in wrong display of filenames in + UTF-8 locales. + It is also possible to specify default codepage and iocharset values for some filesystems during kernel configuration. The relevant parameters diff --git a/chapter08/kernel.xml b/chapter08/kernel.xml index 7a39de32d..7c587db4e 100644 --- a/chapter08/kernel.xml +++ b/chapter08/kernel.xml @@ -91,6 +91,8 @@ make modules_install + + After kernel compilation is complete, additional steps are required to complete the installation. Some files need to be copied to the /boot directory. @@ -152,8 +154,9 @@ cp -r Documentation/* /usr/share/doc/linux-&linux-version; never be replaced by the kernel headers. - + + Contents of Linux diff --git a/prologue/hostreqs.xml b/prologue/hostreqs.xml index a0a2db221..e9b6ce09c 100644 --- a/prologue/hostreqs.xml +++ b/prologue/hostreqs.xml @@ -110,6 +110,8 @@ + + To see whether your host system has all the appropriate versions, run the following: cat > version-check.sh << "EOF" diff --git a/prologue/prerequisites.xml b/prologue/prerequisites.xml index 32905f08f..cea90bb49 100644 --- a/prologue/prerequisites.xml +++ b/prologue/prerequisites.xml @@ -30,23 +30,23 @@ - Software-Building-HOWTO - + Software-Building-HOWTO + This is a comprehensive guide to building and installing generic Unix software packages under Linux. - The Linux Users' Guide - + The Linux Users' Guide + This guide covers the usage of assorted Linux software. - The Essential Pre-Reading Hint - + The Essential Pre-Reading Hint + This is an LFS Hint written specifically for users new to Linux. It includes a list of links to excellent sources of information on a diff --git a/prologue/typography.xml b/prologue/typography.xml index ab884840d..cb1ab4893 100644 --- a/prologue/typography.xml +++ b/prologue/typography.xml @@ -52,7 +52,7 @@ EOF <REPLACED TEXT> This format is used to encapsulate text that is not to be typed - as seen or for copy-and-paste operations. + as seen or for copy-and-paste operations. [OPTIONAL TEXT] diff --git a/stylesheets/pdf/lfs-pagesetup.xsl b/stylesheets/pdf/lfs-pagesetup.xsl index 7e19099ce..7194c3e6d 100644 --- a/stylesheets/pdf/lfs-pagesetup.xsl +++ b/stylesheets/pdf/lfs-pagesetup.xsl @@ -109,6 +109,11 @@ + + 0.6em + 0.4em + 0.8em + -- cgit v1.2.3-54-g00ecf