aboutsummaryrefslogtreecommitdiffstats
path: root/part3intro/introduction.xml
blob: 03ac66a8708c6f8782c2f7eb6de03a546a1a4a5c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-part3intro-intro">
  <?dbhtml filename="introduction.html"?>

  <title>Introduction</title>

  <para>This part is divided into three stages: first, building a cross
  compiler and its associated libraries; second, using this cross toolchain
  to build several utilities in a way that isolates them from the host
  distribution; and third, entering the chroot environment (which further improves
  host isolation) and constructing the remaining tools needed to build the final
  system.</para>

  <important><para>This is where the real work of building a new system
  begins. Be very careful to follow the instructions exactly as the book
  shows them. You should try to understand what each command does,
  and no matter how eager you are to finish your build, you should
  refrain from blindly typing the commands as shown. Read the documentation when
  there is something you do not understand. Also, keep track of your typing
  and of the output of commands, by using the <command>tee</command> utility
  to send the terminal output to a file. This makes debugging easier
  if something goes wrong.</para></important>

  <para>The next section is a technical introduction to the build process,
  while the following one presents <emphasis role="strong">very
  important</emphasis> general instructions.</para>

</sect1>