aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/introduction.xml
diff options
context:
space:
mode:
authorManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-02-05 11:33:31 +0000
committerManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-02-05 11:33:31 +0000
commit4ae43249571811cc3e532908edcc4a628f8dcc34 (patch)
treebdb9884103bcafb820af07c66743f684d2efa286 /chapter06/introduction.xml
parent6a82dd9a1814badb87e18df165474a8b89a39b73 (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.xml106
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>