decorate usernames with <systemitem>
[linux_from_scratch.git] / BOOK / part3intro / introduction.xml
blob6d30ffe49087c47364cd7b7c9447ce8c6a542e79
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4   <!ENTITY % general-entities SYSTEM "../general.ent">
5   %general-entities;
6 ]>
8 <sect1 id="ch-part3intro-intro">
9   <?dbhtml filename="introduction.html"?>
11   <title>Introduction</title>
13   <para>This part is divided into three stages: first building a cross
14   compiler and its associated libraries; second, use this cross toolchain
15   to build several utilities in a way that isolates them from the host
16   distribution; third, enter the chroot environment, which further improves
17   host isolation, and build the remaining tools needed to build the final
18   system.</para>
20   <important><para>With this part begins the real work of building a new
21   system. It requires much care in ensuring that the instructions are
22   followed exactly as the book shows them. You should try to understand
23   what they do, and whatever your eagerness to finish your build, you should
24   refrain from blindly type them as shown, but rather read documentation when
25   there is something you do not understand. Also, keep track of your typing
26   and of the output of commands, by sending them to a file, using the
27   <command>tee</command> utility. This allows for better diagnosing
28   if something gets wrong.</para></important>
30   <para>The next section gives a technical introduction to the build process,
31   while the following one contains <emphasis role="strong">very
32   important</emphasis> general instructions.</para>
34 </sect1>