en/handbook/handbook.xml

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book SYSTEM "/dtd/book.dtd">

<!-- $Header: /home/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook.xml,v 1.51 2004/01/06 08:59:10 swift Exp $ -->

<book link="handbook.xml">
<title>Gentoo Handbook</title>

<author title="Chief Architect">
    <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
</author>
<author title="Author">
  <mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>
<author title="Author">
  <mail link="chouser@gentoo.org">Chris Houser</mail>
</author>
<author title="Author">
  <mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
</author>
<author title="Gentoo x86 Developer">
  <mail link="seemant@gentoo.org">Seemant Kulleen</mail>
</author>
<author title="Gentoo Alpha Developer">
  <mail link="taviso@gentoo.org">Tavis Ormandy</mail>
</author>
<author title="Gentoo Alpha Developer">
  <mail link="agriffis@gentoo.org">Aron Griffis</mail>
</author>
<author title="Gentoo AMD64 Developer">
  <mail link="brad_mssw@gentoo.org">Brad House</mail>
</author>
<author title="Gentoo HPPA developer">
  <mail link="gmsoft@gentoo.org">Guy Martin</mail>
</author>
<author title="Gentoo PPC developer">
   <mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
</author>
<author title="Gentoo SPARC developer">
  <mail link="blademan@gentoo.org">Joe Kallar</mail>
</author>
<author title="Editor">
    <mail link="zhen@gentoo.org">John P. Davis</mail>
</author>
<author title="Editor">
    <mail link="Pierre-Henri.Jondot@wanadoo.fr">Pierre-Henri Jondot</mail>
</author>
<author title="Editor">
    <mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
</author>
<author title="Editor">
    <mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
</author>
<author title="Editor">
    <mail link="seo@gentoo.org">Jungmin Seo</mail>
</author>
<author title="Editor">
    <mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
</author>
<author title="Editor">
    <mail link="jhhudso@gentoo.org">Jared Hudson</mail>
</author>
<author title="Editor">
    <mail link="peitolm@gentoo.org">Colin Morey</mail>
</author>
<author title="Editor">
    <mail link="peesh@gentoo.org">Jorge Paulo</mail>
</author>
<author title="Editor">
    <mail link="carl@gentoo.org">Carl Anderson</mail>
</author>
<author title="Editor">
    <mail link="avenj@gentoo.org">Jon Portnoy</mail>
</author>
<author title="Editor">
     <mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
</author>
<author title="Editor">
  <mail link="jmorgan@gentoo.org">Jack Morgan</mail>
</author>
<author title="Editor">
  <mail link="bennyc@gentoo.org">Benny Chuang</mail>
</author>
<author title="Editor">
  <mail link="erwin@gentoo.org">Erwin</mail>
</author>
<author title="Editor">
  <mail link="kumba@gentoo.org">Joshua Kinard</mail>
</author>
<author title="Reviewer">
    <mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
</author>
<author title="Reviewer">
    <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
</author>
<author title="Reviewer">
    <mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
</author>
<author title="Reviewer">
    <mail link="antifa@gentoo.org">Ken Nowack</mail>
</author>
<author title="Contributor">
   <mail link="pylon@gentoo.org">Lars Weiler</mail>
</author>

<abstract>
This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
information.
</abstract>

<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
<license/>

<version>1.13</version>
<date>January 6, 2004</date>

<part>
<title>Installing Gentoo</title>
<abstract>
In this part you learn how to install Gentoo on your system.
</abstract>

<chapter>
<title>About the Gentoo Linux Installation</title>
<abstract>
Users not familiar with Gentoo do not always know that <e>choice</e> is what
Gentoo is all about. 
</abstract>
  <include href="hb-install-about.xml"/>
</chapter>

<chapter>
<title>Choosing the Right Installation Medium</title>
<abstract>
You can install Gentoo in many ways. You can use our LiveCD, an existing
distribution etc. 
</abstract>
  <include href="hb-install-medium.xml"/>
</chapter>

<chapter>
<title>Configuring your Network</title>
<abstract>
If you want to install Gentoo using the Internet, you need to setup
networking.
</abstract>
  <include href="hb-install-network.xml"/>
</chapter>

<chapter>
<title>Preparing the Disks</title>
<abstract>
To be able to install Gentoo, you must create the necessary partitions.
This chapter describes how to partition a disk for future usage.
</abstract>
  <include href="hb-install-disk.xml"/>
</chapter>

<chapter>
<title>Installing the Gentoo Installation Files</title>
<abstract>
Gentoo installs work through socalled stage-files. In this chapter we
describe how you extract a stage-file and configure Portage.
</abstract>
  <include href="hb-install-stage.xml"/>
</chapter>

<chapter>
<title>Installing the Gentoo Base System</title>
<abstract>
Independent of what stage you chose, the eventual result is that you
have a Gentoo base system at your disposal. This chapter describes how
to progress to that stadium.
</abstract>
  <include href="hb-install-system.xml"/>
</chapter>

<chapter>
<title>Configuring the Kernel</title>
<abstract>
The Linux kernel is the core of every distribution. This chapter
explains how to configure your kernel.
</abstract>
  <include href="hb-install-kernel.xml"/>
</chapter>

<chapter>
<title>Configuring your System</title>
<abstract>
You need to edit some important configuration files. In this chapter
you receive an overview of these files and an explanation on how to
proceed.
</abstract>
  <include href="hb-install-config.xml"/>
</chapter>

<chapter>
<title>Configuring the Bootloader</title>
<abstract>
Several bootloaders exist. Each one of them has its own way of
configuration. In this chapter we'll describe all possibilities for you
and step you through the process of configuring a bootloader to your
needs.
</abstract>
  <include href="hb-install-bootloader.xml"/>
</chapter>

<chapter>
<title>Installing Necessary System Tools</title>
<abstract>
As mentioned before, Gentoo is about choices. In this chapter we help you
choose and install some important tools.
</abstract>
  <include href="hb-install-tools.xml"/>
</chapter>

<chapter>
<title>Finalizing your Gentoo Installation</title>
<abstract>
You're almost done. We'll just create one (or more) users for your
system and leave the installation to reboot into a brand new Gentoo
system.
</abstract>
  <include href="hb-install-finalise.xml"/>
</chapter>

<chapter>
<title>Where to go from here?</title>
<abstract>
Now you have your Gentoo system, but what's next? 
</abstract>
  <include href="hb-install-next.xml"/>
</chapter>
</part>

<part>
<title>Working with Gentoo</title>
<abstract>
Learn how to work with Gentoo: installing software, altering variables, changing
portage' behaviour etc. 
</abstract>

<chapter>
<title>USE flags</title>
<abstract>
USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
work with USE-flags and understand how USE-flags interact with your system.
</abstract>
  <include href="hb-working-use.xml"/>
</chapter>

<chapter>
<title>Portage and Software</title>
<abstract>
The main reason for portage is to maintain the software on your system. In this
chapter you learn how to get information from a package, update your package
database, install/remove/update software and more...
</abstract>
  <include href="hb-working-portage.xml"/>
</chapter>

<chapter>
<title>Portage Features</title>
<abstract>
Gentoo's Portage allows for several features that improve portage-related
aspects, such as build time. This chapter explains the existing features.
</abstract>
  <include href="hb-working-features.xml"/>
</chapter>

<chapter>
<title>Controlling Portage Behaviour</title>
<abstract>
You can tweak Portage to your own needs/environment. Learn how to protect files,
select mirrors, change directory locations and more.
</abstract>
  <include href="hb-working-behaviour.xml"/>
</chapter>

<chapter>
<title>Initscripts</title>
<abstract>
Gentoo uses a special initscript format which, amongst other features, allows
dependency-driven decisions and virtual initscripts. This chapter explains all
these aspects and explains how to deal with these scripts.
</abstract>
  <include href="hb-working-rcscripts.xml"/>
</chapter>

<chapter>
<title>Environment Variables</title>
<abstract>
With Gentoo you can easily manage the environment variables for your system.
This chapter explains how you do that, and also describes frequently used
variables.
</abstract>
  <include href="hb-working-variables.xml"/>
</chapter>
</part>

</book>
1	swift	1.1	<?xml version='1.0' encoding='UTF-8'?>
2			<!DOCTYPE book SYSTEM "/dtd/book.dtd">
3	swift	1.16
4	swift	1.52	<!-- $Header: /home/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook.xml,v 1.51 2004/01/06 08:59:10 swift Exp $ -->
5	swift	1.16
6	swift	1.1	<book link="handbook.xml">
7			<title>Gentoo Handbook</title>
8
9			<author title="Chief Architect">
10			<mail link="drobbins@gentoo.org">Daniel Robbins</mail>
11			</author>
12			<author title="Author">
13			<mail link="swift@gentoo.org">Sven Vermeulen</mail>
14			</author>
15			<author title="Author">
16			<mail link="chouser@gentoo.org">Chris Houser</mail>
17			</author>
18			<author title="Author">
19			<mail link="jerry@gentoo.org">Jerry Alexandratos</mail>
20			</author>
21			<author title="Gentoo x86 Developer">
22			<mail link="seemant@gentoo.org">Seemant Kulleen</mail>
23			</author>
24			<author title="Gentoo Alpha Developer">
25			<mail link="taviso@gentoo.org">Tavis Ormandy</mail>
26			</author>
27			<author title="Gentoo Alpha Developer">
28			<mail link="agriffis@gentoo.org">Aron Griffis</mail>
29			</author>
30	swift	1.47	<author title="Gentoo AMD64 Developer">
31			<mail link="brad_mssw@gentoo.org">Brad House</mail>
32			</author>
33	swift	1.1	<author title="Gentoo HPPA developer">
34			<mail link="gmsoft@gentoo.org">Guy Martin</mail>
35			</author>
36			<author title="Gentoo PPC developer">
37			<mail link="pvdabeel@gentoo.org">Pieter Van den Abeele</mail>
38			</author>
39			<author title="Gentoo SPARC developer">
40			<mail link="blademan@gentoo.org">Joe Kallar</mail>
41			</author>
42			<author title="Editor">
43			<mail link="zhen@gentoo.org">John P. Davis</mail>
44			</author>
45			<author title="Editor">
46			<mail link="Pierre-Henri.Jondot@wanadoo.fr">Pierre-Henri Jondot</mail>
47			</author>
48			<author title="Editor">
49			<mail link="stocke2@gentoo.org">Eric Stockbridge</mail>
50			</author>
51			<author title="Editor">
52			<mail link="rajiv@gentoo.org">Rajiv Manglani</mail>
53			</author>
54			<author title="Editor">
55			<mail link="seo@gentoo.org">Jungmin Seo</mail>
56			</author>
57			<author title="Editor">
58			<mail link="zhware@gentoo.org">Stoyan Zhekov</mail>
59			</author>
60			<author title="Editor">
61			<mail link="jhhudso@gentoo.org">Jared Hudson</mail>
62			</author>
63			<author title="Editor">
64			<mail link="peitolm@gentoo.org">Colin Morey</mail>
65			</author>
66			<author title="Editor">
67			<mail link="peesh@gentoo.org">Jorge Paulo</mail>
68			</author>
69			<author title="Editor">
70			<mail link="carl@gentoo.org">Carl Anderson</mail>
71			</author>
72			<author title="Editor">
73			<mail link="avenj@gentoo.org">Jon Portnoy</mail>
74			</author>
75			<author title="Editor">
76			<mail link="klasikahl@gentoo.org">Zack Gilburd</mail>
77			</author>
78			<author title="Editor">
79			<mail link="jmorgan@gentoo.org">Jack Morgan</mail>
80			</author>
81			<author title="Editor">
82			<mail link="bennyc@gentoo.org">Benny Chuang</mail>
83			</author>
84	erwin	1.31	<author title="Editor">
85			<mail link="erwin@gentoo.org">Erwin</mail>
86			</author>
87	swift	1.35	<author title="Editor">
88			<mail link="kumba@gentoo.org">Joshua Kinard</mail>
89			</author>
90	swift	1.1	<author title="Reviewer">
91			<mail link="g2boojum@gentoo.org">Grant Goodyear</mail>
92			</author>
93			<author title="Reviewer">
94			<mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail>
95			</author>
96			<author title="Reviewer">
97			<mail link="spyderous@gentoo.org">Donnie Berkholz</mail>
98			</author>
99			<author title="Reviewer">
100			<mail link="antifa@gentoo.org">Ken Nowack</mail>
101			</author>
102			<author title="Contributor">
103			<mail link="pylon@gentoo.org">Lars Weiler</mail>
104			</author>
105
106			<abstract>
107			This is the Gentoo Handbook, an effort to centralise Gentoo/Linux
108			information.
109			</abstract>
110
111	swift	1.9	<!-- The content of this document is licensed under the CC-BY-SA license -->
112			<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
113	swift	1.4	<license/>
114
115	swift	1.52	<version>1.13</version>
116	swift	1.50	<date>January 6, 2004</date>
117	swift	1.1
118	swift	1.6	<part>
119	swift	1.1	<title>Installing Gentoo</title>
120			<abstract>
121	swift	1.6	In this part you learn how to install Gentoo on your system.
122	swift	1.1	</abstract>
123
124	swift	1.6	<chapter>
125	swift	1.1	<title>About the Gentoo Linux Installation</title>
126			<abstract>
127	swift	1.18	Users not familiar with Gentoo do not always know that <e>choice</e> is what
128	swift	1.1	Gentoo is all about.
129			</abstract>
130			<include href="hb-install-about.xml"/>
131	swift	1.6	</chapter>
132	swift	1.1
133	swift	1.6	<chapter>
134	swift	1.1	<title>Choosing the Right Installation Medium</title>
135			<abstract>
136			You can install Gentoo in many ways. You can use our LiveCD, an existing
137			distribution etc.
138			</abstract>
139			<include href="hb-install-medium.xml"/>
140	swift	1.6	</chapter>
141	swift	1.1
142	swift	1.6	<chapter>
143	swift	1.1	<title>Configuring your Network</title>
144			<abstract>
145			If you want to install Gentoo using the Internet, you need to setup
146			networking.
147			</abstract>
148			<include href="hb-install-network.xml"/>
149	swift	1.6	</chapter>
150	swift	1.1
151	swift	1.6	<chapter>
152	swift	1.1	<title>Preparing the Disks</title>
153			<abstract>
154			To be able to install Gentoo, you must create the necessary partitions.
155	swift	1.6	This chapter describes how to partition a disk for future usage.
156	swift	1.1	</abstract>
157			<include href="hb-install-disk.xml"/>
158	swift	1.6	</chapter>
159	swift	1.1
160	swift	1.6	<chapter>
161	swift	1.1	<title>Installing the Gentoo Installation Files</title>
162			<abstract>
163	swift	1.6	Gentoo installs work through socalled stage-files. In this chapter we
164	swift	1.28	describe how you extract a stage-file and configure Portage.
165	swift	1.1	</abstract>
166			<include href="hb-install-stage.xml"/>
167	swift	1.6	</chapter>
168	swift	1.1
169	swift	1.6	<chapter>
170	swift	1.1	<title>Installing the Gentoo Base System</title>
171			<abstract>
172			Independent of what stage you chose, the eventual result is that you
173	swift	1.6	have a Gentoo base system at your disposal. This chapter describes how
174	swift	1.1	to progress to that stadium.
175			</abstract>
176			<include href="hb-install-system.xml"/>
177	swift	1.6	</chapter>
178	swift	1.1
179	swift	1.6	<chapter>
180	swift	1.1	<title>Configuring the Kernel</title>
181			<abstract>
182	swift	1.6	The Linux kernel is the core of every distribution. This chapter
183	swift	1.1	explains how to configure your kernel.
184			</abstract>
185			<include href="hb-install-kernel.xml"/>
186	swift	1.6	</chapter>
187	swift	1.1
188	swift	1.6	<chapter>
189	swift	1.5	<title>Configuring your System</title>
190			<abstract>
191	swift	1.6	You need to edit some important configuration files. In this chapter
192	swift	1.5	you receive an overview of these files and an explanation on how to
193			proceed.
194			</abstract>
195			<include href="hb-install-config.xml"/>
196	swift	1.6	</chapter>
197	swift	1.5
198	swift	1.6	<chapter>
199	swift	1.1	<title>Configuring the Bootloader</title>
200			<abstract>
201			Several bootloaders exist. Each one of them has its own way of
202	swift	1.6	configuration. In this chapter we'll describe all possibilities for you
203	swift	1.1	and step you through the process of configuring a bootloader to your
204			needs.
205			</abstract>
206			<include href="hb-install-bootloader.xml"/>
207	swift	1.6	</chapter>
208	swift	1.1
209	swift	1.6	<chapter>
210	swift	1.1	<title>Installing Necessary System Tools</title>
211			<abstract>
212	swift	1.27	As mentioned before, Gentoo is about choices. In this chapter we help you
213			choose and install some important tools.
214	swift	1.1	</abstract>
215			<include href="hb-install-tools.xml"/>
216	swift	1.6	</chapter>
217	swift	1.1
218	swift	1.6	<chapter>
219	swift	1.33	<title>Finalizing your Gentoo Installation</title>
220	swift	1.1	<abstract>
221			You're almost done. We'll just create one (or more) users for your
222			system and leave the installation to reboot into a brand new Gentoo
223	swift	1.24	system.
224	swift	1.1	</abstract>
225			<include href="hb-install-finalise.xml"/>
226	swift	1.6	</chapter>
227	swift	1.1
228	swift	1.6	<chapter>
229	swift	1.1	<title>Where to go from here?</title>
230			<abstract>
231			Now you have your Gentoo system, but what's next?
232			</abstract>
233			<include href="hb-install-next.xml"/>
234			</chapter>
235	swift	1.6	</part>
236	swift	1.39
237			<part>
238			<title>Working with Gentoo</title>
239			<abstract>
240			Learn how to work with Gentoo: installing software, altering variables, changing
241			portage' behaviour etc.
242			</abstract>
243
244			<chapter>
245			<title>USE flags</title>
246			<abstract>
247			USE-flags are a very important aspect of Gentoo. In this chapter, you learn to
248			work with USE-flags and understand how USE-flags interact with your system.
249			</abstract>
250			<include href="hb-working-use.xml"/>
251			</chapter>
252
253			<chapter>
254			<title>Portage and Software</title>
255			<abstract>
256			The main reason for portage is to maintain the software on your system. In this
257			chapter you learn how to get information from a package, update your package
258			database, install/remove/update software and more...
259			</abstract>
260			<include href="hb-working-portage.xml"/>
261			</chapter>
262
263			<chapter>
264			<title>Portage Features</title>
265			<abstract>
266			Gentoo's Portage allows for several features that improve portage-related
267			aspects, such as build time. This chapter explains the existing features.
268			</abstract>
269			<include href="hb-working-features.xml"/>
270			</chapter>
271
272			<chapter>
273			<title>Controlling Portage Behaviour</title>
274			<abstract>
275			You can tweak Portage to your own needs/environment. Learn how to protect files,
276			select mirrors, change directory locations and more.
277			</abstract>
278			<include href="hb-working-behaviour.xml"/>
279			</chapter>
280
281			<chapter>
282			<title>Initscripts</title>
283			<abstract>
284			Gentoo uses a special initscript format which, amongst other features, allows
285			dependency-driven decisions and virtual initscripts. This chapter explains all
286			these aspects and explains how to deal with these scripts.
287			</abstract>
288			<include href="hb-working-rcscripts.xml"/>
289			</chapter>
290
291			<chapter>
292			<title>Environment Variables</title>
293			<abstract>
294			With Gentoo you can easily manage the environment variables for your system.
295			This chapter explains how you do that, and also describes frequently used
296			variables.
297			</abstract>
298			<include href="hb-working-variables.xml"/>
299			</chapter>
300			</part>
301
302	swift	1.1	</book>