/[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.1 Revision 1.122
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.122 2004/03/26 07:45:59 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
109<!-- The content of this document is licensed under the CC-BY-SA license -->
110<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
111<license/>
112
99<version>0.1</version> 113<version>1.84</version>
100<date>October 7, 2003</date> 114<date>March 26, 2004</date>
101 115
102<chapter> 116<part>
103<title>Installing Gentoo</title> 117<title>Installing Gentoo</title>
104<abstract> 118<abstract>
105In this chapter you learn how to install Gentoo on your system. 119In this part you learn how to install Gentoo on your system.
106</abstract> 120</abstract>
107 121
108<section> 122<chapter>
109<title>About the Gentoo Linux Installation</title> 123<title>About the Gentoo Linux Installation</title>
110<abstract> 124<abstract>
111Users 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
112Gentoo is all about. 126Gentoo is all about.
113</abstract> 127</abstract>
114 <include href="hb-install-about.xml"/> 128 <include href="hb-install-about.xml"/>
115</section> 129</chapter>
116 130
117<section> 131<chapter>
118<title>Choosing the Right Installation Medium</title> 132<title>Choosing the Right Installation Medium</title>
119<abstract> 133<abstract>
120You 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
121distribution etc. 135distribution etc.
122</abstract> 136</abstract>
123 <include href="hb-install-medium.xml"/> 137 <include href="hb-install-medium.xml"/>
124</section> 138</chapter>
125 139
126<section> 140<chapter>
127<title>Configuring your Network</title> 141<title>Configuring your Network</title>
128<abstract> 142<abstract>
129If 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
130networking. 144networking.
131</abstract> 145</abstract>
132 <include href="hb-install-network.xml"/> 146 <include href="hb-install-network.xml"/>
133</section> 147</chapter>
134 148
135<section> 149<chapter>
136<title>Preparing the Disks</title> 150<title>Preparing the Disks</title>
137<abstract> 151<abstract>
138To be able to install Gentoo, you must create the necessary partitions. 152To be able to install Gentoo, you must create the necessary partitions.
139This section describes how to partition a disk for future usage. 153This chapter describes how to partition a disk for future usage.
140</abstract> 154</abstract>
141 <include href="hb-install-disk.xml"/> 155 <include href="hb-install-disk.xml"/>
142</section> 156</chapter>
143 157
144<section> 158<chapter>
145<title>Installing the Gentoo Installation Files</title> 159<title>Installing the Gentoo Installation Files</title>
146<abstract> 160<abstract>
147Gentoo installs work through socalled stage-files. In this section we 161Gentoo installs work through socalled stage-files. In this chapter we
148describe how you extract a stage-file and chroot into your system. 162describe how you extract a stage-file and configure Portage.
149</abstract> 163</abstract>
150 <include href="hb-install-stage.xml"/> 164 <include href="hb-install-stage.xml"/>
151</section> 165</chapter>
152 166
153<section> 167<chapter>
154<title>Installing the Gentoo Base System</title> 168<title>Installing the Gentoo Base System</title>
155<abstract> 169<abstract>
156Independent of what stage you chose, the eventual result is that you 170Independent of what stage you chose, the eventual result is that you
157have a Gentoo base system at your disposal. This section describes how 171have a Gentoo base system at your disposal. This chapter describes how
158to progress to that stadium. 172to progress to that stadium.
159</abstract> 173</abstract>
160 <include href="hb-install-system.xml"/> 174 <include href="hb-install-system.xml"/>
161</section> 175</chapter>
162 176
163<section> 177<chapter>
164<title>Configuring the Kernel</title> 178<title>Configuring the Kernel</title>
165<abstract> 179<abstract>
166The Linux kernel is the core of every distribution. This section 180The Linux kernel is the core of every distribution. This chapter
167explains how to configure your kernel. 181explains how to configure your kernel.
168</abstract> 182</abstract>
169 <include href="hb-install-kernel.xml"/> 183 <include href="hb-install-kernel.xml"/>
170</section> 184</chapter>
171 185
172<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>
173<title>Configuring the Bootloader</title> 197<title>Configuring the Bootloader</title>
174<abstract> 198<abstract>
175Several bootloaders exist. Each one of them has its own way of 199Several bootloaders exist. Each one of them has its own way of
176configuration. In this section we'll describe all possibilities for you 200configuration. In this chapter we'll describe all possibilities for you
177and step you through the process of configuring a bootloader to your 201and step you through the process of configuring a bootloader to your
178needs. 202needs.
179</abstract> 203</abstract>
180 <include href="hb-install-bootloader.xml"/> 204 <include href="hb-install-bootloader.xml"/>
181</section> 205</chapter>
182 206
183<section> 207<chapter>
184<title>Configuring your System</title>
185<abstract>
186You need to edit some important configuration files. In this section
187you receive an overview of these files and an explanation on how to
188proceed.
189</abstract>
190 <include href="hb-install-config.xml"/>
191</section>
192
193<section>
194<title>Installing Necessary System Tools</title> 208<title>Installing Necessary System Tools</title>
195<abstract> 209<abstract>
196As mentioned before, Gentoo is about choices. In this section we help 210As mentioned before, Gentoo is about choices. In this chapter we help you
197you install tools of which you have the choice of choosing from. 211choose and install some important tools.
198</abstract> 212</abstract>
199 <include href="hb-install-tools.xml"/> 213 <include href="hb-install-tools.xml"/>
200</section> 214</chapter>
201 215
202<section> 216<chapter>
203<title>Finalising your Gentoo Installation</title> 217<title>Finalizing your Gentoo Installation</title>
204<abstract> 218<abstract>
205You'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
206system and leave the installation to reboot into a brand new Gentoo 220system and leave the installation to reboot into a brand new Gentoo
207installation. 221system.
208</abstract> 222</abstract>
209 <include href="hb-install-finalise.xml"/> 223 <include href="hb-install-finalise.xml"/>
210</section> 224</chapter>
211 225
212<section> 226<chapter>
213<title>Where to go from here?</title> 227<title>Where to go from here?</title>
214<abstract> 228<abstract>
215Now you have your Gentoo system, but what's next? 229Now you have your Gentoo system, but what's next?
216</abstract> 230</abstract>
217 <include href="hb-install-next.xml"/> 231 <include href="hb-install-next.xml"/>
218</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
219</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
220</book> 300</book>

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.122

  ViewVC Help
Powered by ViewVC 1.1.20