diff options
author | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-02-05 11:33:31 +0000 |
---|---|---|
committer | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-02-05 11:33:31 +0000 |
commit | 4ae43249571811cc3e532908edcc4a628f8dcc34 (patch) | |
tree | bdb9884103bcafb820af07c66743f684d2efa286 /chapter06/introduction.xml | |
parent | 6a82dd9a1814badb87e18df165474a8b89a39b73 (diff) |
Indenting chapter 6, part 6
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7348 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter06/introduction.xml')
-rw-r--r-- | chapter06/introduction.xml | 106 |
1 files changed, 52 insertions, 54 deletions
diff --git a/chapter06/introduction.xml b/chapter06/introduction.xml index 065baeeed..5e9cfd5c3 100644 --- a/chapter06/introduction.xml +++ b/chapter06/introduction.xml @@ -1,67 +1,65 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="ch-system-introduction"> -<title>Introduction</title> -<?dbhtml filename="introduction.html"?> + <?dbhtml filename="introduction.html"?> -<para>In this chapter, we enter the building site and start -constructing the LFS system in earnest. That is, we chroot into the -temporary mini Linux system, make a few final preparations, and then -begin installing the packages.</para> + <title>Introduction</title> -<para>The installation of this software is straightforward. Although -in many cases the installation instructions could be made shorter and -more generic, we have opted to provide the full instructions for every -package to minimize the possibilities for mistakes. The key to -learning what makes a Linux system work is to know what each package -is used for and why the user (or the system) needs it. For every -installed package, a summary of its contents is given, followed by -concise descriptions of each program and library the package -installed.</para> + <para>In this chapter, we enter the building site and start constructing the + LFS system in earnest. That is, we chroot into the temporary mini Linux system, + make a few final preparations, and then begin installing the packages.</para> -<para>If using the compiler optimizations provided in this chapter, -please review the optimization hint at <ulink -url="&hints-root;optimization.txt"/>. Compiler optimizations can make -a program run slightly faster, but they may also cause compilation -difficulties and problems when running the program. If a package -refuses to compile when using optimization, try to compile it without -optimization and see if that fixes the problem. Even if the package -does compile when using optimization, there is the risk it may have -been compiled incorrectly because of the complex interactions between -the code and build tools. Also note that the <option>-march</option> -and <option>-mtune</option> options may cause problems with the -toolchain packages (Binutils, GCC and Glibc). The small potential -gains achieved in using compiler optimizations are often outweighed by -the risks. First-time builders of LFS are encouraged to build without -custom optimizations. The subsequent system will still run very fast -and be stable at the same time.</para> + <para>The installation of this software is straightforward. Although in many + cases the installation instructions could be made shorter and more generic, + we have opted to provide the full instructions for every package to minimize + the possibilities for mistakes. The key to learning what makes a Linux system + work is to know what each package is used for and why the user (or the system) + needs it. For every installed package, a summary of its contents is given, + followed by concise descriptions of each program and library the package + installed.</para> -<para>The order that packages are installed in this chapter needs to -be strictly followed to ensure that no program accidentally acquires a -path referring to <filename class="directory">/tools</filename> -hard-wired into it. For the same reason, do not compile packages in -parallel. Compiling in parallel may save time (especially on dual-CPU -machines), but it could result in a program containing a hard-wired -path to <filename class="directory">/tools</filename>, which will -cause the program to stop working when that directory is -removed.</para> + <para>If using the compiler optimizations provided in this chapter, please + review the optimization hint at <ulink url="&hints-root;optimization.txt"/>. + Compiler optimizations can make a program run slightly faster, but they may + also cause compilation difficulties and problems when running the program. + If a package refuses to compile when using optimization, try to compile it + without optimization and see if that fixes the problem. Even if the package + does compile when using optimization, there is the risk it may have been + compiled incorrectly because of the complex interactions between the code + and build tools. Also note that the <option>-march</option> and + <option>-mtune</option> options may cause problems with the toolchain packages + (Binutils, GCC and Glibc). The small potential gains achieved in using + compiler optimizations are often outweighed by the risks. First-time builders + of LFS are encouraged to build without custom optimizations. The subsequent + system will still run very fast and be stable at the same time.</para> -<para>Before the installation instructions, each installation page -provides information about the package, including a concise -description of what it contains, approximately how long it will take -to build, how much disk space is required during this building -process, and any other packages needed to successfully build the -package. Following the installation instructions, there is a list of -programs and libraries (along with brief descriptions of these) that -the package installs.</para> + <para>The order that packages are installed in this chapter needs to be + strictly followed to ensure that no program accidentally acquires a path + referring to <filename class="directory">/tools</filename> hard-wired into + it. For the same reason, do not compile packages in parallel. Compiling in + parallel may save time (especially on dual-CPU machines), but it could result + in a program containing a hard-wired path to <filename + class="directory">/tools</filename>, which will cause the program to stop + working when that directory is removed.</para> -<note><para>At this point, you may wish to keep your finished temporary -tools for use in future LFS builds by creating a tarball of the -<filename class="directory">/tools</filename> directory and -storing it in a safe location.</para></note> + <para>Before the installation instructions, each installation page provides + information about the package, including a concise description of what it + contains, approximately how long it will take to build, how much disk space + is required during this building process, and any other packages needed to + successfully build the package. Following the installation instructions, + there is a list of programs and libraries (along with brief descriptions of + these) that the package installs.</para> -</sect1> + <note> + <para>At this point, you may wish to keep your finished temporary + tools for use in future LFS builds by creating a tarball of the + <filename class="directory">/tools</filename> directory and + storing it in a safe location.</para> + </note> +</sect1> |