source: clfs-sysroot/BOOK/materials/common/introduction.xml@ 7a95c74

Last change on this file since 7a95c74 was c439b8a, checked in by Manuel Canales Esparcia <manuel@…>, 18 years ago

Updated CLFS-Sysroot book sources to use DocBook-XML DTD 4.5.

  • Property mode set to 100644
File size: 2.1 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-materials-introduction">
9 <?dbhtml filename="introduction.html"?>
10
11 <title>Introduction</title>
12
13 <para>This chapter includes a list of packages that need to be downloaded
14 for building a basic Linux system. The listed version numbers correspond
15 to versions of the software that are known to work, and this book is based
16 on their use. We highly recommend not using newer versions because the
17 build commands for one version may not work with a newer version. The
18 newest package versions may also have problems that require work-arounds.
19 These work-arounds will be developed and stabilized in the development
20 version of the book.</para>
21
22 <para>Download locations may not always be accessible. If a download
23 location has changed since this book was published, Google (<ulink
24 url="http://www.google.com/"/>) provides a useful search engine for
25 most packages. If this search is unsuccessful, try one of the
26 alternative means of downloading discussed at <ulink
27 url="&packages-root;"/>.</para>
28
29 <para>Create a directory called
30 <filename class="directory">${CLFS}/sources</filename> and use it to store
31 your sources and patches. All packages should be compiled there as well.
32 Using any other location for compiling may have unexpected results.</para>
33
34 <para>To create this directory, execute, as user <systemitem
35 class="username">root</systemitem>, the following command before
36 starting the download session:</para>
37
38<screen><userinput>mkdir -v ${CLFS}/sources</userinput></screen>
39
40 <para>Make this directory writable and sticky. When a directory is
41 marked <quote>sticky</quote>, that means that even if multiple users have
42 write permission on that directory, any file within that directory can only be
43 deleted or modified by its owner. The following command will enable the
44 write and sticky modes:</para>
45
46<screen><userinput>chmod -v a+wt ${CLFS}/sources</userinput></screen>
47
48</sect1>
Note: See TracBrowser for help on using the repository browser.