source: clfs-embedded/BOOK/final-system/common/introduction.xml@ 31fac76

Last change on this file since 31fac76 was 7f6542c, checked in by Andrew Bradford <andrew@…>, 8 years ago

final-system/introduction: Clarify parallel compiling concern

Using 'make -j 2' is OK, compiling busybox and musl at the same time is
not.

  • Property mode set to 100644
File size: 1.8 KB
Line 
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]>
7
8<sect1 id="ch-system-introduction">
9 <?dbhtml filename="introduction.html"?>
10
11 <title>Introduction</title>
12
13 <para os="a">In this chapter, we enter the building site and start
14 constructing the CLFS system in earnest. The installation of this
15 software is straightforward. Although in many cases the installation
16 instructions could be made shorter and more generic, we have opted
17 to provide the full instructions for every package to minimize the
18 possibilities for mistakes. The key to learning what makes a Linux
19 system work is to know what each package is used for and why the user
20 (or the system) needs it. For every installed package, a summary of
21 its contents is given, followed by concise descriptions of each
22 program and library the package installed.</para>
23
24 <para os="b">The order that packages are installed in this chapter needs to
25 be strictly followed to ensure that no program accidentally acquires a
26 path referring to <filename class="directory">${CLFS}/cross-tools</filename>
27 hard-wired into it. For the same reason, do not compile packages in
28 parallel. Compiling more than one package at a time may save time,
29 but it could result in a program containing a hard-wired
30 path to <filename class="directory">${CLFS}/cross-tools</filename>, which will
31 cause the program to stop working when that directory is
32 removed.</para>
33
34 <para os="c">Compiling any single package using make's parallel job execution
35 option, "-j" is OK if you want to speed up compiling any one package.</para>
36
37</sect1>
Note: See TracBrowser for help on using the repository browser.