/[gentoo]/xml/htdocs/doc/en/handbook/handbook.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/handbook.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

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

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.108

  ViewVC Help
Powered by ViewVC 1.1.20