| 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 | |
3 | |
| 4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.2 2004/04/02 12:07:42 swift Exp $ --> |
4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.110 2004/10/21 10:31:20 swift Exp $ --> |
| 5 | |
5 | |
| 6 | <book link="handbook-amd64.xml"> |
6 | <book link="handbook-amd64.xml"> |
| 7 | <title>Gentoo Linux/AMD64 Handbook</title> |
7 | <title>Gentoo Linux/AMD64 Handbook</title> |
| 8 | |
8 | |
| 9 | <author title="Chief Architect"> |
9 | <author title="Author"> |
| 10 | <mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
10 | <mail link="drobbins@gentoo.org">Daniel Robbins</mail> |
| 11 | </author> |
11 | </author> |
| 12 | <author title="Author"> |
12 | <author title="Author"> |
| 13 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
13 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
| 14 | </author> |
14 | </author> |
| … | |
… | |
| 26 | </author> |
26 | </author> |
| 27 | <author title="Gentoo Alpha Developer"> |
27 | <author title="Gentoo Alpha Developer"> |
| 28 | <mail link="agriffis@gentoo.org">Aron Griffis</mail> |
28 | <mail link="agriffis@gentoo.org">Aron Griffis</mail> |
| 29 | </author> |
29 | </author> |
| 30 | <author title="Gentoo AMD64 Developer"> |
30 | <author title="Gentoo AMD64 Developer"> |
| 31 | <mail link="brad_mssw@gentoo.org">Brad House</mail> |
31 | <mail link="jhuebel@gentoo.org">Jason Huebel</mail> |
| 32 | </author> |
32 | </author> |
| 33 | <author title="Gentoo HPPA developer"> |
33 | <author title="Gentoo HPPA developer"> |
| 34 | <mail link="gmsoft@gentoo.org">Guy Martin</mail> |
34 | <mail link="gmsoft@gentoo.org">Guy Martin</mail> |
| 35 | </author> |
35 | </author> |
| 36 | <author title="Gentoo PPC developer"> |
36 | <author title="Gentoo PPC developer"> |
| … | |
… | |
| 83 | <mail link="erwin@gentoo.org">Erwin</mail> |
83 | <mail link="erwin@gentoo.org">Erwin</mail> |
| 84 | </author> |
84 | </author> |
| 85 | <author title="Editor"> |
85 | <author title="Editor"> |
| 86 | <mail link="kumba@gentoo.org">Joshua Kinard</mail> |
86 | <mail link="kumba@gentoo.org">Joshua Kinard</mail> |
| 87 | </author> |
87 | </author> |
|
|
88 | <author title="Editor"> |
|
|
89 | <mail link="dertobi123@gentoo.org">Tobias Scherbaum</mail> |
|
|
90 | </author> |
| 88 | <author title="Reviewer"> |
91 | <author title="Reviewer"> |
| 89 | <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
92 | <mail link="g2boojum@gentoo.org">Grant Goodyear</mail> |
| 90 | </author> |
93 | </author> |
| 91 | <author title="Reviewer"> |
94 | <author title="Reviewer"> |
| 92 | <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
95 | <mail link="gerrynjr@gentoo.org">Gerald J. Normandin Jr.</mail> |
| … | |
… | |
| 105 | This is the Gentoo Handbook, an effort to centralise Gentoo/Linux |
108 | This is the Gentoo Handbook, an effort to centralise Gentoo/Linux |
| 106 | information. |
109 | information. |
| 107 | </abstract> |
110 | </abstract> |
| 108 | |
111 | |
| 109 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
112 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 110 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
113 | <!-- See http://creativecommons.org/licenses/by-sa/2.0 --> |
| 111 | <license/> |
114 | <license/> |
| 112 | |
115 | |
| 113 | <version>2.00</version> |
116 | <version>3.6</version> |
| 114 | <date>April 2, 2004</date> |
117 | <date>October 21, 2004</date> |
| 115 | |
118 | |
| 116 | <part> |
119 | <part> |
| 117 | <title>Installing Gentoo</title> |
120 | <title>Installing Gentoo</title> |
| 118 | <abstract> |
121 | <abstract> |
| 119 | In this part you learn how to install Gentoo on your system. |
122 | In this part you learn how to install Gentoo on your system. |
| … | |
… | |
| 129 | </chapter> |
132 | </chapter> |
| 130 | |
133 | |
| 131 | <chapter> |
134 | <chapter> |
| 132 | <title>Choosing the Right Installation Medium</title> |
135 | <title>Choosing the Right Installation Medium</title> |
| 133 | <abstract> |
136 | <abstract> |
| 134 | You can install Gentoo in many ways. You can use our LiveCD, an existing |
137 | You can install Gentoo in many ways. This chapter explains how to install Gentoo |
| 135 | distribution etc. |
138 | using a Gentoo LiveCD. |
| 136 | </abstract> |
139 | </abstract> |
| 137 | <include href="hb-install-amd64-medium.xml"/> |
140 | <include href="hb-install-amd64-medium.xml"/> |
| 138 | </chapter> |
141 | </chapter> |
| 139 | |
142 | |
| 140 | <chapter> |
143 | <chapter> |
| … | |
… | |
| 156 | </chapter> |
159 | </chapter> |
| 157 | |
160 | |
| 158 | <chapter> |
161 | <chapter> |
| 159 | <title>Installing the Gentoo Installation Files</title> |
162 | <title>Installing the Gentoo Installation Files</title> |
| 160 | <abstract> |
163 | <abstract> |
| 161 | Gentoo installs work through socalled stage-files. In this chapter we |
164 | Gentoo installs work through so-called stage-files. In this chapter we |
| 162 | describe how you extract a stage-file and configure Portage. |
165 | describe how you extract a stage-file and configure Portage. |
| 163 | </abstract> |
166 | </abstract> |
| 164 | <include href="hb-install-stage.xml"/> |
167 | <include href="hb-install-stage.xml"/> |
| 165 | </chapter> |
168 | </chapter> |
| 166 | |
169 | |
| … | |
… | |
| 192 | </abstract> |
195 | </abstract> |
| 193 | <include href="hb-install-config.xml"/> |
196 | <include href="hb-install-config.xml"/> |
| 194 | </chapter> |
197 | </chapter> |
| 195 | |
198 | |
| 196 | <chapter> |
199 | <chapter> |
| 197 | <title>Configuring the Bootloader</title> |
|
|
| 198 | <abstract> |
|
|
| 199 | Several bootloaders exist. Each one of them has its own way of |
|
|
| 200 | configuration. In this chapter we'll describe all possibilities for you |
|
|
| 201 | and step you through the process of configuring a bootloader to your |
|
|
| 202 | needs. |
|
|
| 203 | </abstract> |
|
|
| 204 | <include href="hb-install-amd64-bootloader.xml"/> |
|
|
| 205 | </chapter> |
|
|
| 206 | |
|
|
| 207 | <chapter> |
|
|
| 208 | <title>Installing Necessary System Tools</title> |
200 | <title>Installing Necessary System Tools</title> |
| 209 | <abstract> |
201 | <abstract> |
| 210 | As mentioned before, Gentoo is about choices. In this chapter we help you |
202 | As mentioned before, Gentoo is about choices. In this chapter we help you |
| 211 | choose and install some important tools. |
203 | choose and install some important tools. |
| 212 | </abstract> |
204 | </abstract> |
| 213 | <include href="hb-install-tools.xml"/> |
205 | <include href="hb-install-tools.xml"/> |
| 214 | </chapter> |
206 | </chapter> |
| 215 | |
207 | |
| 216 | <chapter> |
208 | <chapter> |
|
|
209 | <title>Configuring the Bootloader</title> |
|
|
210 | <abstract> |
|
|
211 | In this chapter we'll describe the GRUB bootloader |
|
|
212 | and step you through the process of configuring GRUB to your |
|
|
213 | needs. |
|
|
214 | </abstract> |
|
|
215 | <include href="hb-install-amd64-bootloader.xml"/> |
|
|
216 | </chapter> |
|
|
217 | |
|
|
218 | <chapter> |
| 217 | <title>Finalizing your Gentoo Installation</title> |
219 | <title>Finalizing your Gentoo Installation</title> |
| 218 | <abstract> |
220 | <abstract> |
| 219 | You're almost done. We'll just create one (or more) users for your |
221 | You're almost done. We'll just create one (or more) users for your |
| 220 | system and leave the installation to reboot into a brand new Gentoo |
222 | system and (optionally) install the prebuild packages. |
| 221 | system. |
|
|
| 222 | </abstract> |
223 | </abstract> |
| 223 | <include href="hb-install-finalise.xml"/> |
224 | <include href="hb-install-finalise.xml"/> |
| 224 | </chapter> |
225 | </chapter> |
| 225 | |
226 | |
| 226 | <chapter> |
227 | <chapter> |
| … | |
… | |
| 238 | Learn how to work with Gentoo: installing software, altering variables, changing |
239 | Learn how to work with Gentoo: installing software, altering variables, changing |
| 239 | portage behaviour etc. |
240 | portage behaviour etc. |
| 240 | </abstract> |
241 | </abstract> |
| 241 | |
242 | |
| 242 | <chapter> |
243 | <chapter> |
|
|
244 | <title>A Portage Introduction</title> |
|
|
245 | <abstract> |
|
|
246 | This chapter explains the "simple" steps a user definitely needs to know to |
|
|
247 | maintain the software on his system. |
|
|
248 | </abstract> |
|
|
249 | <include href="hb-working-portage.xml"/> |
|
|
250 | </chapter> |
|
|
251 | |
|
|
252 | <chapter> |
| 243 | <title>USE flags</title> |
253 | <title>USE flags</title> |
| 244 | <abstract> |
254 | <abstract> |
| 245 | USE-flags are a very important aspect of Gentoo. In this chapter, you learn to |
255 | USE-flags are a very important aspect of Gentoo. In this chapter, you learn to |
| 246 | work with USE-flags and understand how USE-flags interact with your system. |
256 | work with USE-flags and understand how USE-flags interact with your system. |
| 247 | </abstract> |
257 | </abstract> |
| 248 | <include href="hb-working-use.xml"/> |
258 | <include href="hb-working-use.xml"/> |
| 249 | </chapter> |
259 | </chapter> |
| 250 | |
260 | |
| 251 | <chapter> |
261 | <chapter> |
| 252 | <title>Portage and Software</title> |
|
|
| 253 | <abstract> |
|
|
| 254 | The main reason for portage is to maintain the software on your system. In this |
|
|
| 255 | chapter you learn how to get information from a package, update your package |
|
|
| 256 | database, 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> |
262 | <title>Portage Features</title> |
| 263 | <abstract> |
263 | <abstract> |
| 264 | Gentoo's Portage allows for several features that improve portage-related |
264 | Discover the features Portage has, such as support for distributed compiling, |
| 265 | aspects, such as build time. This chapter explains the existing features. |
265 | ccache and more. |
| 266 | </abstract> |
266 | </abstract> |
| 267 | <include href="hb-working-features.xml"/> |
267 | <include href="hb-working-features.xml"/> |
| 268 | </chapter> |
|
|
| 269 | |
|
|
| 270 | <chapter> |
|
|
| 271 | <title>Controlling Portage Behaviour</title> |
|
|
| 272 | <abstract> |
|
|
| 273 | You can tweak Portage to your own needs/environment. Learn how to protect files, |
|
|
| 274 | select mirrors, change directory locations and more. |
|
|
| 275 | </abstract> |
|
|
| 276 | <include href="hb-working-behaviour.xml"/> |
|
|
| 277 | </chapter> |
268 | </chapter> |
| 278 | |
269 | |
| 279 | <chapter> |
270 | <chapter> |
| 280 | <title>Initscripts</title> |
271 | <title>Initscripts</title> |
| 281 | <abstract> |
272 | <abstract> |
| … | |
… | |
| 295 | </abstract> |
286 | </abstract> |
| 296 | <include href="hb-working-variables.xml"/> |
287 | <include href="hb-working-variables.xml"/> |
| 297 | </chapter> |
288 | </chapter> |
| 298 | </part> |
289 | </part> |
| 299 | |
290 | |
|
|
291 | <part> |
|
|
292 | <title>Working with Portage</title> |
|
|
293 | <abstract> |
|
|
294 | "Working with Portage" provides an in-depth coverage of Portage, Gentoo's |
|
|
295 | Software Management Tool. |
|
|
296 | </abstract> |
|
|
297 | |
|
|
298 | <chapter> |
|
|
299 | <title>Files and Directories</title> |
|
|
300 | <abstract> |
|
|
301 | Once you want to know Portage in-depth you need to know where it stores it's |
|
|
302 | files and data. |
|
|
303 | </abstract> |
|
|
304 | <include href="hb-portage-files.xml"/> |
|
|
305 | </chapter> |
|
|
306 | |
|
|
307 | <chapter> |
|
|
308 | <title>Configuring through Variables</title> |
|
|
309 | <abstract> |
|
|
310 | Portage is completely configurable through various variables you can set in the |
|
|
311 | configuration file or as environment variable. |
|
|
312 | </abstract> |
|
|
313 | <include href="hb-portage-configuration.xml"/> |
|
|
314 | </chapter> |
|
|
315 | |
|
|
316 | <chapter> |
|
|
317 | <title>Mixing Software Branches</title> |
|
|
318 | <abstract> |
|
|
319 | Gentoo provides software separated in several branches, depending on stability |
|
|
320 | and architectural support. "Mixing Software Branches" inform you how these |
|
|
321 | branches can be configured and how you can override this separation |
|
|
322 | individually. |
|
|
323 | </abstract> |
|
|
324 | <include href="hb-portage-branches.xml"/> |
|
|
325 | </chapter> |
|
|
326 | |
|
|
327 | <chapter> |
|
|
328 | <title>Additional Portage Tools</title> |
|
|
329 | <abstract> |
|
|
330 | Portage comes with a few extra tools that might make your Gentoo experience even |
|
|
331 | better. Read on to discover how to use dispatch-conf and other tools. |
|
|
332 | </abstract> |
|
|
333 | <include href="hb-portage-tools.xml"/> |
|
|
334 | </chapter> |
|
|
335 | |
|
|
336 | <chapter> |
|
|
337 | <title>Diverting from the Official Tree</title> |
|
|
338 | <abstract> |
|
|
339 | "Diverting from the Official Tree" gives you some tips and tricks on how to use |
|
|
340 | your own Portage tree, how to synchronise only the categories you want, inject |
|
|
341 | packages and more. |
|
|
342 | </abstract> |
|
|
343 | <include href="hb-portage-diverttree.xml"/> |
|
|
344 | </chapter> |
|
|
345 | |
|
|
346 | <chapter> |
|
|
347 | <title>The Ebuild Application</title> |
|
|
348 | <abstract> |
|
|
349 | In "The Ebuild Application" you are informed about the steps Portage takes while |
|
|
350 | installing software and how you can do this yourself using the ebuild |
|
|
351 | application. |
|
|
352 | </abstract> |
|
|
353 | <include href="hb-portage-ebuild.xml"/> |
|
|
354 | </chapter> |
|
|
355 | </part> |
|
|
356 | |
| 300 | </book> |
357 | </book> |