diff options
-rw-r--r-- | chapter01/how.xml | 24 | ||||
-rw-r--r-- | chapter02/aboutlfs.xml | 2 | ||||
-rw-r--r-- | chapter02/aboutsbus.xml | 2 | ||||
-rw-r--r-- | chapter02/abouttestsuites.xml | 8 | ||||
-rw-r--r-- | chapter02/chapter02.xml | 2 | ||||
-rw-r--r-- | chapter03/chapter03.xml | 2 | ||||
-rw-r--r-- | chapter04/chapter04.xml | 2 | ||||
-rw-r--r-- | chapter05/chapter05.xml | 12 | ||||
-rw-r--r-- | chapter05/gcc-pass2.xml | 2 | ||||
-rw-r--r-- | chapter05/glibc.xml | 6 | ||||
-rw-r--r-- | chapter05/tcl.xml | 2 | ||||
-rw-r--r-- | chapter06/aboutdebug.xml | 2 | ||||
-rw-r--r-- | chapter06/bootscripts.xml | 2 | ||||
-rw-r--r-- | chapter06/chapter06.xml | 6 | ||||
-rw-r--r-- | chapter06/gcc-2953.xml | 2 | ||||
-rw-r--r-- | chapter06/gcc.xml | 2 | ||||
-rw-r--r-- | chapter07/chapter07.xml | 2 | ||||
-rw-r--r-- | chapter07/loadkeys.xml | 2 | ||||
-rw-r--r-- | chapter08/chapter08.xml | 2 | ||||
-rw-r--r-- | chapter09/chapter09.xml | 2 |
20 files changed, 43 insertions, 43 deletions
diff --git a/chapter01/how.xml b/chapter01/how.xml index 12c17db6e..c5fb2f96b 100644 --- a/chapter01/how.xml +++ b/chapter01/how.xml @@ -9,26 +9,26 @@ programs like a compiler, linker and shell to build the new system. Normally all the required tools are available if you selected <quote>development</quote> as one of the options when you installed your distribution.</para> -<para>In <xref linkend="chapter03"/> you will first create a new Linux native +<para>In <xref linkend="chapter-making-space"/> you will first create a new Linux native partition and file system, the place where your new LFS system will be compiled -and installed. Then in <xref linkend="chapter04"/> you download all the +and installed. Then in <xref linkend="chapter-getting-materials"/> you download all the packages and patches required to build an LFS system, and store them on the new file system.</para> -<para><xref linkend="chapter05"/> then discusses the installation of a number +<para><xref linkend="chapter-temporary-tools"/> then discusses the installation of a number of packages that will form the basic development suite (or toolchain) which is -used to build the actual system in <xref linkend="chapter06"/>. Some of these +used to build the actual system in <xref linkend="chapter-building-system"/>. Some of these packages are needed to resolve circular dependencies -- for example, to compile a compiler you need a compiler.</para> -<para>The first thing to be done in <xref linkend="chapter05"/> is build a +<para>The first thing to be done in <xref linkend="chapter-temporary-tools"/> is build a first pass of the toolchain, made up of Binutils and GCC. The programs from these packages will be linked statically in order for them to be usable independently of the host system. The second thing to do is build Glibc, the C library. Glibc will be compiled by the toolchain programs we just built in the first pass. The third thing to do is build a second pass of the toolchain. This time the toolchain will be dynamically linked against the newly built -Glibc. The remaining <xref linkend="chapter05"/> packages are all built using +Glibc. The remaining <xref linkend="chapter-temporary-tools"/> packages are all built using this second pass toolchain and dynamically linked against the new host-independent Glibc. When this is done, the LFS installation process will no longer depend on the host distribution, with the exception of the running @@ -36,10 +36,10 @@ kernel.</para> <para>You may be thinking that <quote>this seems like a lot of work, just to get away from my host distribution</quote>. Well, a full technical explanation -is provided at the start of <xref linkend="chapter05"/>, including some notes +is provided at the start of <xref linkend="chapter-temporary-tools"/>, including some notes on the differences between statically and dynamically linked programs.</para> -<para>In <xref linkend="chapter06"/> your real LFS system will be built. The +<para>In <xref linkend="chapter-building-system"/> your real LFS system will be built. The chroot (change root) program is used to enter a virtual environment and start a new shell whose root directory will be set to the LFS partition. This is very similar to rebooting and instructing the kernel to mount the LFS partition as @@ -52,8 +52,8 @@ Console) or X desktop and continue using the computer as you normally would.</para> <para>To finish the installation, the bootscripts are set up in -<xref linkend="chapter07"/>, the kernel and bootloader are set up in -<xref linkend="chapter08"/>, and <xref linkend="chapter09"/> contains some +<xref linkend="chapter-bootscripts"/>, the kernel and bootloader are set up in +<xref linkend="chapter-mixture"/>, and <xref linkend="chapter-finalizing"/> contains some pointers to help you after you finish the book. Then, finally, you're ready to reboot your computer into your new LFS system.</para> @@ -62,9 +62,9 @@ will take are discussed in the chapters and package descriptions as you progress through them. If something isn't completely clear now, don't worry, everything will fall into place soon.</para> -<para>Please read <xref linkend="chapter02"/> carefully as it explains a few +<para>Please read <xref linkend="chapter-preparation"/> carefully as it explains a few important things you should be aware of before you begin to work through -<xref linkend="chapter05"/> and beyond.</para> +<xref linkend="chapter-temporary-tools"/> and beyond.</para> </sect1> diff --git a/chapter02/aboutlfs.xml b/chapter02/aboutlfs.xml index ff1ecf0e0..7aac118ba 100644 --- a/chapter02/aboutlfs.xml +++ b/chapter02/aboutlfs.xml @@ -6,7 +6,7 @@ variable LFS will be used frequently. $LFS must at all times be replaced with the directory where the partition that contains the LFS system is mounted. How to create and where to mount the partition will be explained in full detail in -<xref linkend="chapter03"/>. For the moment let's assume that the LFS partition +<xref linkend="chapter-making-space"/>. For the moment let's assume that the LFS partition is mounted on <filename>/mnt/lfs</filename>.</para> <para>When you are told to run a command like diff --git a/chapter02/aboutsbus.xml b/chapter02/aboutsbus.xml index d1a7485e5..cf2685e70 100644 --- a/chapter02/aboutsbus.xml +++ b/chapter02/aboutsbus.xml @@ -12,7 +12,7 @@ with the idea of using the <emphasis>Static Binutils Unit</emphasis> (abbreviated to <emphasis>SBU</emphasis>).</para> <para>It works like this: the first package you compile in this book is the -statically linked Binutils in <xref linkend="chapter05"/>, and the time it +statically linked Binutils in <xref linkend="chapter-temporary-tools"/>, and the time it takes to compile this package is what we call the "Static Binutils Unit" or "SBU". All other compile times will be expressed relative to this time.</para> diff --git a/chapter02/abouttestsuites.xml b/chapter02/abouttestsuites.xml index 258f35352..e580a9a79 100644 --- a/chapter02/abouttestsuites.xml +++ b/chapter02/abouttestsuites.xml @@ -16,12 +16,12 @@ properly functioning system. But be warned, the test suites for GCC and Glibc can take a very long time to complete, especially on slower hardware.</para> <para>Experience has shown us that there is little to be gained from running -the test suites in <xref linkend="chapter05"/>. There can be no escaping the +the test suites in <xref linkend="chapter-temporary-tools"/>. There can be no escaping the fact that the host system always exerts influence on the tests in that chapter, often causing weird and inexplicable failures. Not only that, the tools built -in <xref linkend="chapter05"/> are temporary and eventually discarded. For the +in <xref linkend="chapter-temporary-tools"/> are temporary and eventually discarded. For the average reader of this book we recommend <emphasis>not</emphasis> to run the -test suites in <xref linkend="chapter05"/>. The instructions for running those +test suites in <xref linkend="chapter-temporary-tools"/>. The instructions for running those test suites are still provided for the benefit of testers and developers, but they are strictly optional for everyone else.</para> @@ -35,7 +35,7 @@ is running out of pseudo terminals (PTYs for short). The symptom is an unusually high number of failing tests. This can happen for a number of reasons. Most likely is that the host system doesn't have the <emphasis>devpts</emphasis> file system set up correctly. We'll discuss this in -more detail later on in <xref linkend="chapter05"/>.</para></note> +more detail later on in <xref linkend="chapter-temporary-tools"/>.</para></note> </sect1> diff --git a/chapter02/chapter02.xml b/chapter02/chapter02.xml index 3265cac98..9d6956300 100644 --- a/chapter02/chapter02.xml +++ b/chapter02/chapter02.xml @@ -1,4 +1,4 @@ -<chapter id="chapter02" xreflabel="Chapter 2"> +<chapter id="chapter-preparation" xreflabel="Chapter 2"> <title>Important information</title> <?dbhtml filename="chapter02.html" dir="chapter02"?> diff --git a/chapter03/chapter03.xml b/chapter03/chapter03.xml index 9f59c60e1..cdbe189d6 100644 --- a/chapter03/chapter03.xml +++ b/chapter03/chapter03.xml @@ -1,4 +1,4 @@ -<chapter id="chapter03" xreflabel="Chapter 3"> +<chapter id="chapter-making-space" xreflabel="Chapter 3"> <title>Preparing a new partition</title> <?dbhtml filename="chapter03.html" dir="chapter03"?> diff --git a/chapter04/chapter04.xml b/chapter04/chapter04.xml index f2770f786..79e770ccd 100644 --- a/chapter04/chapter04.xml +++ b/chapter04/chapter04.xml @@ -1,4 +1,4 @@ -<chapter id="chapter04" xreflabel="Chapter 4"> +<chapter id="chapter-getting-materials" xreflabel="Chapter 4"> <title>The materials: packages and patches</title> <?dbhtml filename="chapter04.html" dir="chapter04"?> diff --git a/chapter05/chapter05.xml b/chapter05/chapter05.xml index a2734acc8..8e5699990 100644 --- a/chapter05/chapter05.xml +++ b/chapter05/chapter05.xml @@ -1,4 +1,4 @@ -<chapter id="chapter05" xreflabel="Chapter 5"> +<chapter id="chapter-temporary-tools" xreflabel="Chapter 5"> <title>Constructing a temporary system</title> <?dbhtml filename="chapter05.html" dir="chapter05"?> @@ -71,10 +71,10 @@ details behind the overall build method. It's not essential that you understand everything here immediately. Most of it will make sense once you have performed an actual build. Feel free to refer back here at any time.</para> -<para>The overall goal of <xref linkend="chapter05"/> is to provide a sane, +<para>The overall goal of <xref linkend="chapter-temporary-tools"/> is to provide a sane, temporary environment that we can chroot into, and from which we can produce a clean, trouble-free build of the target LFS system in -<xref linkend="chapter06"/>. Along the way, we attempt to divorce ourselves +<xref linkend="chapter-building-system"/>. Along the way, we attempt to divorce ourselves from the host system as much as possible, and in so doing build a self-contained and self-hosted toolchain. It should be noted that the build process has been designed in such a way so as to minimize the risks for @@ -109,7 +109,7 @@ the <filename>shlib-versions</filename> file in the root of the Glibc source tree.</para> </important> -<para>Some key technical points of how the <xref linkend="chapter05"/> build +<para>Some key technical points of how the <xref linkend="chapter-temporary-tools"/> build method works:</para> <itemizedlist> @@ -207,10 +207,10 @@ would defeat our goal of getting away from the host.</para> <emphasis>--with-lib-path</emphasis> configure switch to control <command>ld</command>'s library search path. From this point onwards, the core toolchain is self-contained and self-hosted. The remainder of the -<xref linkend="chapter05"/> packages all build against the new Glibc in +<xref linkend="chapter-temporary-tools"/> packages all build against the new Glibc in <filename class="directory">/tools</filename> and all is well.</para> -<para>Upon entering the chroot environment in <xref linkend="chapter06"/>, the +<para>Upon entering the chroot environment in <xref linkend="chapter-building-system"/>, the first major package we install is Glibc, due to its self-sufficient nature that we mentioned above. Once this Glibc is installed into <filename class="directory">/usr</filename>, we perform a quick changeover of diff --git a/chapter05/gcc-pass2.xml b/chapter05/gcc-pass2.xml index 462f92f0b..b8dcbaa60 100644 --- a/chapter05/gcc-pass2.xml +++ b/chapter05/gcc-pass2.xml @@ -50,7 +50,7 @@ process is warranted here. Under normal circumstances, the GCC fixincludes script scans your system for header files that need to be fixed. It might find that some Glibc header files on your host system need to be fixed, fix them and put them in the GCC private include directory. Then, later on in -<xref linkend="chapter06"/>, after we've installed the newer Glibc, this +<xref linkend="chapter-building-system"/>, after we've installed the newer Glibc, this private include directory would be searched before the system include directory, resulting in GCC finding the fixed headers from the host system, which would most likely not match the Glibc version actually used for the LFS diff --git a/chapter05/glibc.xml b/chapter05/glibc.xml index 5b5f1d77e..1340cc9c0 100644 --- a/chapter05/glibc.xml +++ b/chapter05/glibc.xml @@ -90,7 +90,7 @@ so:</para> system, in particular the kernel. Additionally, here in this chapter some tests can be adversely affected by existing tools or environmental issues on the host system. Of course, these won't be a problem when we run the Glibc test suite -inside the chroot environment of <xref linkend="chapter06"/>. In general, the +inside the chroot environment of <xref linkend="chapter-building-system"/>. In general, the Glibc test suite is always expected to pass. However, as mentioned above, some failures are unavoidable in certain circumstances. Here is a list of the most common issues we are aware of:</para> @@ -117,9 +117,9 @@ fail due to test timeouts being exceeded.</para></listitem> </itemizedlist> <para>In summary, don't worry too much if you see Glibc test suite failures -here in this chapter. The Glibc in <xref linkend="chapter06"/> is the one we'll +here in this chapter. The Glibc in <xref linkend="chapter-building-system"/> is the one we'll ultimately end up using so that is the one we would really like to see pass. -But please keep in mind, even in <xref linkend="chapter06"/> some failures +But please keep in mind, even in <xref linkend="chapter-building-system"/> some failures could still occur -- the <emphasis>math</emphasis> tests for example. When experiencing a failure, make a note of it, then continue by reissuing the <command>make check</command>. The test suite diff --git a/chapter05/tcl.xml b/chapter05/tcl.xml index 4788f3875..1668a895d 100644 --- a/chapter05/tcl.xml +++ b/chapter05/tcl.xml @@ -48,7 +48,7 @@ here are not surprising, but are not considered critical:</para> Coordinated Universal Time (UTC) also known as Greenwich Mean Time (GMT), but only for the duration of the test suite run. This ensures the clock tests are exercised correctly. More information on the TZ environment variable will be -given later on in <xref linkend="chapter07"/>.</para></listitem> +given later on in <xref linkend="chapter-bootscripts"/>.</para></listitem> </itemizedlist> <para>Sometimes package test suites will give false failures. You can diff --git a/chapter06/aboutdebug.xml b/chapter06/aboutdebug.xml index ccf05b83e..6708deb54 100644 --- a/chapter06/aboutdebug.xml +++ b/chapter06/aboutdebug.xml @@ -41,7 +41,7 @@ or ELF binary), run <command>strip --strip-debug filename</command>. Wildcards can be used to treat multiple files (use something like <userinput>strip --strip-debug $LFS/tools/bin/*</userinput>).</para> -<para>For your convenience, <xref linkend="chapter09"/> includes one simple +<para>For your convenience, <xref linkend="chapter-finalizing"/> includes one simple command to strip all debugging symbols from all programs and libraries on your system. Additional information on optimization can be found in the hint at <ulink url="&hints-root;optimization.txt"/>.</para> diff --git a/chapter06/bootscripts.xml b/chapter06/bootscripts.xml index bb2a511ab..159470d1f 100644 --- a/chapter06/bootscripts.xml +++ b/chapter06/bootscripts.xml @@ -23,7 +23,7 @@ like something more radical, search the LFS mailing lists for depinit.</para> <para>If you decide to use BSD style, or some other style scripts, you can skip the next chapter when you arrive at it and move on to -<xref linkend="chapter08"/>.</para> +<xref linkend="chapter-mixture"/>.</para> <para>Install the boot scripts:</para> diff --git a/chapter06/chapter06.xml b/chapter06/chapter06.xml index ef78e75e7..44ec75c9e 100644 --- a/chapter06/chapter06.xml +++ b/chapter06/chapter06.xml @@ -1,4 +1,4 @@ -<chapter id="chapter06" xreflabel="Chapter 6"> +<chapter id="chapter-building-system" xreflabel="Chapter 6"> <title>Installing basic system software</title> <?dbhtml filename="chapter06.html" dir="chapter06"?> @@ -269,7 +269,7 @@ freely by the user, as well-written packages don't depend on GID numbers but use the group's name.</para> <para>To get rid of the "I have no name!" prompt, we will start a new shell. -Since we installed a full Glibc in <xref linkend="chapter05"/>, and have just +Since we installed a full Glibc in <xref linkend="chapter-temporary-tools"/>, and have just created the <filename>/etc/passwd</filename> and <filename>/etc/group</filename> files, user name and group name resolution will now work.</para> @@ -325,7 +325,7 @@ adjusted linker by running the following from within the <note><para>If you somehow missed the earlier warning to retain the Binutils source and build directories from the second pass in -<xref linkend="chapter05"/>, or otherwise accidentally deleted them or just +<xref linkend="chapter-temporary-tools"/>, or otherwise accidentally deleted them or just don't have access to them, don't worry, all is not lost. Just ignore the above command. The result will be that the next package, Binutils, will link against the Glibc libraries in <filename class="directory">/tools</filename> rather diff --git a/chapter06/gcc-2953.xml b/chapter06/gcc-2953.xml index e79db7dbf..171c4d908 100644 --- a/chapter06/gcc-2953.xml +++ b/chapter06/gcc-2953.xml @@ -28,7 +28,7 @@ default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting or modifying them when building GCC.</para> <para>This is an older release of GCC which we are going to install for the -purpose of compiling the Linux kernel in <xref linkend="chapter08"/>. This +purpose of compiling the Linux kernel in <xref linkend="chapter-mixture"/>. This version is recommended by the kernel developers when you need absolute stability. Later versions of GCC have not received as much testing for Linux kernel compilation. Using a diff --git a/chapter06/gcc.xml b/chapter06/gcc.xml index 824307bd6..7cf0f81a4 100644 --- a/chapter06/gcc.xml +++ b/chapter06/gcc.xml @@ -92,7 +92,7 @@ compiler. To satisfy those packages, create a symlink:</para> we performed earlier in this chapter. Refer back to <xref linkend="ch-system-adjustingtoolchain"/> and repeat the check. If the results are wrong, then most likely you erroneously applied the GCC Specs patch from -<xref linkend="chapter05"/>.</para></note> +<xref linkend="chapter-temporary-tools"/>.</para></note> </sect2> diff --git a/chapter07/chapter07.xml b/chapter07/chapter07.xml index c85b1d60c..7e07e8ecd 100644 --- a/chapter07/chapter07.xml +++ b/chapter07/chapter07.xml @@ -1,4 +1,4 @@ -<chapter id="chapter07" xreflabel="Chapter 7"> +<chapter id="chapter-bootscripts" xreflabel="Chapter 7"> <title>Setting up system boot scripts</title> <?dbhtml filename="chapter07.html" dir="chapter07"?> diff --git a/chapter07/loadkeys.xml b/chapter07/loadkeys.xml index 2a864c088..770c307d7 100644 --- a/chapter07/loadkeys.xml +++ b/chapter07/loadkeys.xml @@ -3,7 +3,7 @@ <?dbhtml filename="loadkeys.html" dir="chapter07"?> <para>If you decided to compile your keymap file directly into the kernel back -at the end of <xref linkend="chapter06"/>, then you strictly speaking don't +at the end of <xref linkend="chapter-building-system"/>, then you strictly speaking don't need to run this loadkeys script, since the kernel has already set up the keymap for you. You can still run it if you want, it isn't going to hurt you. It could even be beneficial to keep it in case you run a lot of different diff --git a/chapter08/chapter08.xml b/chapter08/chapter08.xml index 258d394f7..b83bf7691 100644 --- a/chapter08/chapter08.xml +++ b/chapter08/chapter08.xml @@ -1,4 +1,4 @@ -<chapter id="chapter08" xreflabel="Chapter 8"> +<chapter id="chapter-mixture" xreflabel="Chapter 8"> <title>Making the LFS system bootable</title> <?dbhtml filename="chapter08.html" dir="chapter08"?> diff --git a/chapter09/chapter09.xml b/chapter09/chapter09.xml index bb04f7f52..10af4f606 100644 --- a/chapter09/chapter09.xml +++ b/chapter09/chapter09.xml @@ -1,4 +1,4 @@ -<chapter id="chapter09" xreflabel="Chapter 9"> +<chapter id="chapter-finalizing" xreflabel="Chapter 9"> <title>The End</title> <?dbhtml filename="chapter09.html" dir="chapter09"?> |