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

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

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

Revision 1.1 Revision 1.79
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/index.xml,v 1.79 2004/08/31 18:57:03 neysx Exp $ -->
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE mainpage SYSTEM "/dtd/guide.dtd">
3<mainpage id="docs"> 4<mainpage id="docs">
4 <title>Gentoo Documentation Resources</title> 5 <title>Gentoo Documentation Resources</title>
5 <author title="Author"> 6 <author title="Author">
6 <mail link="drobbins@gentoo.org">Daniel Robbins</mail> 7 <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
7 </author> 8 </author>
8 <author title="Editor"> 9 <author title="Editor"><!-- zhen@gentoo.org -->
9 <mail link="zhen@gentoo.org">John P. Davis</mail> 10 John P. Davis
10 </author> 11 </author>
11 <author title="Editor">Colin Morey</author> 12 <author title="Editor">Colin Morey</author>
12 <author title="Editor"> 13 <author title="Editor">
13 <mail link="peesh@gentoo.org">Jorge Paulo</mail> 14 <mail link="peesh@gentoo.org">Jorge Paulo</mail>
14 </author> 15 </author>
15 <author title="Editor"> 16 <author title="Editor">
16 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 17 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
17 </author> 18 </author>
18 <version>1.0.91</version> 19<version>2.37</version>
19 <date>October 6, 2003</date> 20<date>August 30, 2004</date>
20 21
21<chapter> 22<chapter>
22<title>Gentoo Documentation Resources</title> 23<title>Gentoo Documentation Resources</title>
24<section>
25<title>Available Languages</title>
26<body>
27
28<p>
29This page (and documentation) is available in the following languages:
30</p>
31
32<p>
33<uri link="http://www.gentoo.org/doc/da/index.xml">Danish</uri> |
34<uri link="http://www.gentoo.org/doc/nl/index.xml">Dutch</uri> |
35<uri link="http://www.gentoo.org/doc/en/index.xml">English</uri> |
36<uri link="http://www.gentoo.org/doc/fr/index.xml">French</uri> |
37<uri link="http://www.gentoo.org/doc/de/index.xml">German</uri> |
38<uri link="http://www.gentoo.org/doc/hu/index.xml">Hungarian</uri> |
39<!-- <uri link="http://www.gentoo.org/doc/id/index.xml">Indonesian</uri> | -->
40<uri link="http://www.gentoo.org/doc/it/index.xml">Italian</uri> |
41<uri link="http://www.gentoo.org/doc/ja/index.xml">Japanese</uri> |
42<!-- <uri link="http://www.gentoo.org/doc/kr/index.xml">Korean</uri> | -->
43<uri link="http://www.gentoo.org/doc/ru/index.xml">Russian</uri> |
44<uri link="http://www.gentoo.org/doc/es/index.xml">Spanish</uri> |
45<uri link="http://www.gentoo.org/doc/tw/index.xml">Traditional Chinese</uri>
46</p>
47
48</body>
49</section>
23<section> 50<section>
24<title>Contents</title> 51<title>Contents</title>
25<body> 52<body>
26 53
27<ul> 54<ul>
28<li><uri link="#doc_chap1">Introduction</uri></li> 55<li><uri link="#doc_chap1">Introduction</uri></li>
29<li><uri link="#doc_chap2">Installation Related Resources</uri></li> 56<li><uri link="#doc_chap2">Installation Related Resources</uri></li>
30<li><uri link="#doc_chap3">Gentoo System Documentation</uri></li> 57<li><uri link="#doc_chap3">Gentoo System Documentation</uri></li>
31<li><uri link="#doc_chap4">System Administration Documentation</uri></li> 58<li><uri link="#doc_chap4">System Administration Documentation</uri></li>
32<li><uri link="#doc_chap5">Desktop Related Documentation</uri></li> 59<li><uri link="desktop.xml">Gentoo Desktop Documentation Repository</uri></li>
33<li><uri link="#doc_chap6">Gentoo Development Documentation</uri></li> 60<li><uri link="#doc_chap5">Gentoo Development Documentation</uri></li>
34<li><uri link="#doc_chap7">Other Documentation</uri></li> 61<li><uri link="#doc_chap6">Other Documentation</uri></li>
62<li><uri link="#doc_chap7">Overview of Available Documentation</uri></li>
35</ul> 63</ul>
36 64
37</body> 65</body>
38</section> 66</section>
39<section> 67<section>
51</p> 79</p>
52 80
53<p> 81<p>
54If you find bugs in our documentation or have proposals, please use our 82If you find bugs in our documentation or have proposals, please use our
55<uri link="http://bugs.gentoo.org">Bugtracking System</uri> and fill in 83<uri link="http://bugs.gentoo.org">Bugtracking System</uri> and fill in
56a bug report for "Docs-developer" or "Docs-user". These bugreports will 84a bug report for "Docs-developer" or "Docs-user". These bug reports will
57then be handled by the <uri 85then be handled by the <uri
58link="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation 86link="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation
59Project</uri>. 87Project</uri>.
60</p> 88</p>
61 89
68<p> 96<p>
69Our documentation is available in several languages. Although not all 97Our documentation is available in several languages. Although not all
70documents are translated, we do our best to keep them all up to date and 98documents are translated, we do our best to keep them all up to date and
71provide our users with as much translated documentation as possible. If 99provide our users with as much translated documentation as possible. If
72you want to help with our translation efforts, please contact <mail 100you want to help with our translation efforts, please contact <mail
73link="svyatogor@gentoo.org">Sergey Kuleshov</mail> who is in charge of 101link="neysx@gentoo.org">Xavier Neys</mail> who is in charge of
74the internationalisation efforts. 102the internationalisation efforts.
75</p> 103</p>
76 104
77<p>
78We currently provide documentation for the following languages:
79</p>
80
81<p>
82<uri link="http://www.gentoo.org/doc/nl/index.xml">Dutch</uri> |
83<uri link="http://www.gentoo.org/doc/en/index.xml">English</uri> |
84<uri link="http://www.gentoo.org/doc/fr/index.xml">French</uri> |
85<uri link="http://www.gentoo.org/doc/de/index.xml">German</uri> |
86<uri link="http://www.gentoo.org/doc/hu/index.xml">Hungarian</uri> |
87<uri link="http://www.gentoo.org/doc/id/index.xml">Indonesian</uri> |
88<uri link="http://www.gentoo.org/doc/it/index.xml">Italian</uri> |
89<uri link="http://www.gentoo.org/doc/ja/index.xml">Japanese</uri> |
90<uri link="http://www.gentoo.org/doc/kr/index.xml">Korean</uri> |
91<uri link="http://www.gentoo.org/doc/ru/index.xml">Russian</uri> |
92<uri link="http://www.gentoo.org/doc/es/index.xml">Spanish</uri> |
93<uri link="http://www.gentoo.org/doc/tw/index.xml">Traditional Chinese</uri>
94</p>
95
96</body> 105</body>
97</section> 106</section>
98<section> 107<section>
99<title>Frequently Asked Questions</title> 108<title>Frequently Asked Questions</title>
100<body> 109<body>
101 110
102<p> 111<p>
103As with every major project Gentoo has a FAQ too. We have first and foremost 112As with every major project Gentoo has a FAQ too. We have first and foremost
104two official FAQs maintained by the Gentoo Documentation Project: 113a couple of official FAQs maintained by the Gentoo Documentation Project:
105</p> 114</p>
106 115
107<ul> 116<ul>
108<li>The <b><uri link="faq.xml">Gentoo FAQ</uri></b> answers Frequently Asked Questions 117<li>The <b><uri link="faq.xml">Gentoo FAQ</uri></b> answers Frequently Asked Questions
109about Gentoo Linux with focus on x86 platforms.</li> 118about Gentoo Linux with focus on x86 platforms.</li>
110<li>The <b><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></b> answers Frequently 119<li>The <b><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></b> answers Frequently
111Asked Questions about Gentoo Linux on the PowerPC platform.</li> 120Asked Questions about Gentoo Linux on the PowerPC platform.</li>
121<li>The <b><uri link="gentoo-sparc-faq.xml">Gentoo SPARC FAQ</uri></b> answers
122Frequently Asked Questions about Gentoo Linux on the SPARC platform.</li>
112</ul> 123</ul>
113 124
114<p> 125<p>
115Furthermore we have a very extensive collection of FAQs on our <uri 126Furthermore we have a very extensive collection of FAQs on our <uri
116link="http://forums.gentoo.org">forums</uri>. To view those, go to 127link="http://forums.gentoo.org">forums</uri>. To view those, go to
117<uri>http://forums.gentoo.org/viewforum.php?f=40</uri>. 128<uri>http://forums.gentoo.org/viewforum.php?f=40</uri>.
118</p> 129</p>
119 130
120</body> 131</body>
121</section> 132</section>
133<section>
134<title>Gentoo Handbook</title>
135<body>
136
137<p>
138The Gentoo Documentation Project has started with the <uri
139link="handbook/">Gentoo Handbook</uri> development. Currently, the
140first two parts (<uri link="handbook/handbook-x86.xml?part=1">Installing
141Gentoo</uri> and <uri link="handbook/handbook-x86.xml?part=2">Working with
142Gentoo</uri>) are finished and have reached the "official" stage. Users are
143encouraged to use the installation instructions from the Handbook and <uri
144link="http://bugs.gentoo.org/enter_bug.cgi?product=Docs-user">bug</uri> us with
145their experience (please use the <e>Handbook</e> component).
146</p>
147
148<p>
149More information can be found on the <uri link="handbook/">Gentoo
150Handbook Effort</uri> homepage.
151</p>
152
153</body>
154</section>
122</chapter> 155</chapter>
123 156
124<chapter> 157<chapter>
125<title>Installation Related Resources</title> 158<title>Installation Related Resources</title>
126<section> 159<section>
127<title>Introduction</title> 160<title>Introduction</title>
128<body> 161<body>
129 162
130<p> 163<p>
131The installation related documentation provide information that can be usefull 164The installation related documentation provides information that can be useful
132during the installation of Gentoo Linux. This includes architecture-related 165during the installation of Gentoo Linux. This includes the part on "Installing
133installation resources and tutorials that are to be followed during the 166Gentoo" in our Gentoo Handbook, as well as the older but still maintained
134installation (such as LVM). 167architecture-related installation resources and tutorials that are to be
168followed during the installation.
135</p> 169</p>
136 170
137</body> 171</body>
138</section> 172</section>
139<section> 173<section>
140<title>Installation Guides</title> 174<title>Installation Guides</title>
141<body> 175<body>
142 176
143<p> 177<p>
144The installation guides step you through the process of installing Gentoo 178The first part of our <b><uri link="/doc/en/handbook/index.xml">Gentoo
145Linux 1.4. We support various installation approaches, depending on how much 179Handbook</uri></b> explains how to install Gentoo on your system. Each
146of the system you want to custom-build from scratch. 180architecture-specific version contains instructions for all users.
147</p>
148
149<p> 181</p>
150The installation guides are available for the following architectures: 182
151</p> 183<p>
152 184For experienced users we also have Quick Installation Reference documents:
153<table>
154<tr>
155 <ti>x86</ti>
156 <ti><b><uri link="gentoo-x86-install.xml">Online</uri></b></ti>
157 <ti><b><uri link="gentoo-x86-install.xml?style=printable">Printer Friendly</uri></b></ti>
158</tr>
159<tr>
160 <ti>Alpha</ti>
161 <ti><b><uri link="gentoo-alpha-install.xml">Online</uri></b></ti>
162 <ti><b><uri link="gentoo-alpha-install.xml?style=printable">Printer Friendly</uri></b></ti>
163</tr>
164<tr>
165 <ti>HPPA</ti>
166 <ti><b><uri link="gentoo-hppa-install.xml">Online</uri></b></ti>
167 <ti><b><uri link="gentoo-hppa-install.xml?style=printable">Printer Friendly</uri></b></ti>
168</tr>
169<tr>
170 <ti>PPC</ti>
171 <ti><b><uri link="gentoo-ppc-install.xml">Online</uri></b></ti>
172 <ti><b><uri link="gentoo-ppc-install.xml?style=printable">Printer Friendly</uri></b></ti>
173</tr>
174<tr>
175 <ti>Sparc</ti>
176 <ti><b><uri link="gentoo-sparc-install.xml">Online</uri></b></ti>
177 <ti><b><uri link="gentoo-sparc-install.xml?style=printable">Printer Friendly</uri></b></ti>
178</tr>
179</table>
180
181<p> 185</p>
182Most users will probably need the <b><uri link="gentoo-x86-install.xml">x86 186
183Installation Guide</uri></b>. 187<ul>
184</p> 188 <li><b><uri link="gentoo-x86-quickinstall.xml">x86 Quick Installation Reference</uri></b></li>
189 <li><b><uri link="gentoo-sparc-quickinstall.xml">Sparc Quick Installation Reference</uri></b></li>
190</ul>
185 191
186<p> 192<p>
187Alpha-users are probably also interested in our <b><uri 193Alpha-users are probably also interested in our <b><uri
188link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></b>, which 194link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></b>, which
189explains how to set up the Compaq Tools package for Gentoo Alpha users. 195explains how to set up the Compaq Tools package for Gentoo Alpha users.
196</p>
197
198<p>
199AMD64-users should start with the <b><uri
200link="/proj/en/base/amd64/technotes.xml">AMD64 Technotes</uri></b> which
201contains information about the AMD64 Project, Installation Notes, Download
202Instructions and more.
190</p> 203</p>
191 204
192</body> 205</body>
193</section> 206</section>
194<section> 207<section>
202Installation Guide</uri></b> which lists the installation steps needed to install 215Installation Guide</uri></b> which lists the installation steps needed to install
203Gentoo from another medium (distribution, bootable CD, network boot, etc.). 216Gentoo from another medium (distribution, bootable CD, network boot, etc.).
204</p> 217</p>
205 218
206<p> 219<p>
207Users interested in using LVM should read up our <b><uri link="lvm.xml">LVM 220Users interested in using LVM2 should read up our <b><uri link="lvm2.xml">LVM2
208Guide</uri></b> which explains what steps you have to go through to get your 221Guide</uri></b> which explains the steps required to get your LVM2 scheme up
209LVM scheme up and running. 222and running.
223</p>
224
225<p>
226As our installation instructions allow for great flexibility, there are many
227tips and tricks that can be persued during the installation. We have a <b><uri
228link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Installation Tips 'n
229Tricks</uri></b> document online (which also contains interesting Tips 'n Tricks
230for other architectures).
210</p> 231</p>
211 232
212<p> 233<p>
213The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade 234The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade
214Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to 235Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to
215Gentoo Linux 1.4. 236Gentoo Linux 1.4.
216</p> 237</p>
217 238
239<p>
240The <b><uri link="gentoo-upgrading.xml">Gentoo Upgrading Guide</uri></b> goes
241deeper into the motivation behind the easy-upgrading system Gentoo uses and
242provides more information about the so-called "profiles".
243</p>
244
245<p>
246The <b><uri link="genkernel.xml">Genkernel Guide</uri></b> intends to provide a
247reference of all the functions provided by genkernel.
248</p>
249
250<p>
251With the help of our <b><uri link="colinux-howto.xml">coLinux Howto</uri></b>
252you are able to run Gentoo from within Windows.
253</p>
254
218</body> 255</body>
219</section> 256</section>
220</chapter> 257</chapter>
221 258
222<chapter> 259<chapter>
228<p> 265<p>
229The Gentoo System Documentation contains several guides about what makes 266The Gentoo System Documentation contains several guides about what makes
230Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc. 267Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc.
231</p> 268</p>
232 269
270<p>
271The Gentoo Handbook has a part on <uri
272link="handbook/handbook-x86.xml?part=2">Working with Gentoo</uri> which contains
273information on Portage, USE flags, the Gentoo Init system and environment
274variables.
275</p>
276
233</body> 277</body>
234</section> 278</section>
235<section> 279<section>
236<title>Portage and Related Documentation</title> 280<title>Portage and Related Documentation</title>
237<body> 281<body>
238 282
239<p> 283<p>
240The <b><uri link="portage-user.xml">Portage User Guide</uri></b> briefly covers how 284The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and
285Software</uri></b> chapter in the Gentoo Handbook briefly covers how to keep
241to keep your packages up to date and how to maintain your installed software. 286your packages up to date and how to maintain your installed software. In other
242In other words: this guide tells you how to use <c>emerge</c>. 287words, this chapter tells you how to use <c>emerge</c>.
243</p>
244
245<p> 288</p>
246The <b><uri link="portage-manual.xml">Portage Manual</uri></b> provides a general 289
247overview of Portage, detailed configuration information and an end user guide 290
248to installing and maintaining packages using the Portage system. It is
249far more extended than the Portage User Guide.
250</p> 291<p>
251 292The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=3">Portage
293Features</uri></b> chapter in the Gentoo Handbook provides a general
294overview of Portage' features.
252<p> 295</p>
253The <b><uri link="use-howto.xml">USE Howto</uri></b> introduces you to the ultimate 296
297<p>
298The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=4">Controlling
299Portage Behaviour</uri></b> chapter in the Gentoo Handbook informs you how to
300tweak Portage to suit your environment, your needs.
301</p>
302
303<p>
304The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></b>
305chapter in the Gentoo Handbook introduces you to the ultimate
254tool for customizing Gentoo -- USE flags. This howto helps you decide which 306tool for customizing Gentoo -- USE flags. This howto helps you decide which
255USE flags you need. It also describes the use of <c>etcat</c> to receive 307USE flags you need. It also describes the use of <c>etcat</c> to receive
256more verbatim information regarding USE-flags on a package. 308more verbose information regarding USE-flags on a package.
309</p>
310
311<p>
312The <b><uri link="gentoolkit.xml">Gentoolkit Guide</uri></b> describes a set of
313very useful portage add-ons.
314</p>
315
316<p>
317The <b><uri link="macos-guide.xml">Gentoo for Mac OS X Guide</uri></b> shows
318how to install portage on a Mac OS X system.
257</p> 319</p>
258 320
259</body> 321</body>
260</section> 322</section>
261<section> 323<section>
262<title>Configuring Gentoo</title> 324<title>Configuring Gentoo</title>
263<body> 325<body>
264 326
265<p> 327<p>
266The <b><uri link="env.d-howto.xml">ENV.D Howto</uri></b> explains how to manage 328The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment
329Variables</uri></b> chapter in the Gentoo Handbook explains how to manage
267environment variables (such as <path>$PATH</path>) and the dynamic linker 330environment variables (such as <path>$PATH</path>) and the dynamic linker
268cache easily. 331cache easily.
269</p> 332</p>
270 333
271<p> 334<p>
272The <b><uri link="rc-scripts.xml">RC-Script Guide</uri></b> details our system 335The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></b>
336chapter in the Gentoo Handbook details our system
273startup and service management scripts. Besides the regular 337startup and service management scripts. Besides the regular
274initscript-related items it also covers initscript dependencies and 338initscript-related items it also covers initscript dependencies and
275support for virtuals. 339support for virtuals.
276</p> 340</p>
277 341
331Gentoo Linux. IPv6 is the next Internet Protocol and is gaining 395Gentoo Linux. IPv6 is the next Internet Protocol and is gaining
332popularity widely. 396popularity widely.
333</p> 397</p>
334 398
335<p> 399<p>
336The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use User-Mode 400The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use
337Linux under Gentoo Linux. User Mode Linux (UML) provides a nice feature 401User-Mode Linux under Gentoo Linux. User Mode Linux (UML) provides a nice
338for Linux: Running Linux inside Linux (inside Linux inside Linux ...). 402feature for Linux: Running Linux inside Linux (inside Linux inside Linux ...).
339With UML, you can easily create virtual setups. 403With UML, you can easily create virtual setups.
340</p> 404</p>
341 405
406<!--
407<p>
408The <b><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></b> show you
409how to set up a UML installation with SELinux support.
410</p>
411-->
412
342</body> 413</body>
343</section> 414</section>
344<section> 415<section>
345<title>Specific Administration Guides</title> 416<title>Specific Administration Guides</title>
346<body> 417<body>
347 418
419<!-- Some possible security issues, see #39718
348<p> 420<p>
349The <b><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></b> explains how 421The <b><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></b> explains how
350to administer user accounts centralised using OpenLDAP. 422to administer user accounts centralised using OpenLDAP.
351</p> 423</p>
424-->
352 425
353<p> 426<p>
354The <b><uri link="openmosix-howto.xml">OpenMosix Howto</uri></b> describes step by 427The <b><uri link="openmosix-howto.xml">OpenMosix Howto</uri></b> describes step by
355step how you can create a farm full of diskless openmosix nodes (a 428step how you can create a farm of openmosix nodes (a cluster of several PCs).
356cluster of several PCs). 429</p>
430
431<p>
432The <b><uri link="diskless-howto.xml">Diskless Howto</uri></b> describes step by
433step how you can set up diskless nodes with Gentoo.
357</p> 434</p>
358 435
359<p> 436<p>
360The <b><uri link="ltsp.xml">LTSP Guide</uri></b> explains how to setup a Linux 437The <b><uri link="ltsp.xml">LTSP Guide</uri></b> explains how to setup a Linux
361Terminal Server with Gentoo. 438Terminal Server with Gentoo.
370The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works 447The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works
371and how to administer it. 448and how to administer it.
372</p> 449</p>
373 450
374<p> 451<p>
452The <b><uri link="udev-guide.xml">Gentoo udev Guide</uri></b> describes the new
453device file management (using udev) which replaces DevFS and informs the reader
454how udev is integrated in Gentoo.
455</p>
456
457<p>
375The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive 458The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive
376guide to Gentoo and printing. 459guide to Gentoo and printing.
377</p> 460</p>
378 461
379<p> 462<p>
380The <b><uri link="openafs.xml">OpenAFS Guide</uri></b> documents the use and 463The <b><uri link="openafs.xml">OpenAFS Guide</uri></b> documents the use and
381installation of OpenAFS, a distributed network-based file sharing technology. 464installation of OpenAFS, a distributed network-based file sharing technology.
382</p> 465</p>
383 466
384<p> 467<p>
385The <b><uri link="virt-mail-howto.xml">Virtual/Mailhost Howto</uri></b> is the 468The <b><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></b> is
386essential guide for any mail administrator. It covers the use of MySQL for 469the essential guide for any postfix mail administrator. It covers the use of MySQL
387virtual users, webbased e-mail software, mailinglist software etc. 470for virtual users, webbased e-mail software, mailinglist software etc.
388</p>
389
390</body>
391</section>
392</chapter>
393
394<chapter>
395<title>Desktop Related Documentation</title>
396<section>
397<title>Introduction</title>
398<body>
399
400<p> 471</p>
401The Desktop Related Documentation contains our Desktop Configuration Guide 472
402with several other desktop related documents, including several
403application-specific guides.
404</p> 473<p>
405 474The <b><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></b> is a pretty
406</body> 475useful guide for running a qmail based mail system. It focuses on remote
407</section> 476access and encrypted communication.
408<section>
409<title>Desktop Configuration</title>
410<body>
411
412<p> 477</p>
413The <b><uri link="desktop.xml">Desktop Configuration Guide</uri></b> explains how to 478
414set up a fully-functional Gentoo Linux desktop machine. This includes
415configuring KDE/GNOME, Using e-mail, File Sharing (using Samba), etc.
416</p> 479<p>
417 480The <b><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot
481Howto</uri></b> describes how to setup a network booting environment for a Sun
482Microsystems SPARC or UltraSPARC based computer.
418<p> 483</p>
419The <b><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></b> is a 484
420comprehensive guide on how to install and use ALSA (Advanced Linux Sound
421Architecture).
422</p> 485<p>
423 486 The <b><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM reference
487Guide</uri></b> offers a guide to the SPARC OpenBoot system, available on all
488Sun Microsytsms SPARC/UltraSparc based computers.
424<p> 489</p>
425The <b><uri link="java.xml">Java Guide</uri></b> explains how Java is handled under 490
426Gentoo Linux.
427</p> 491<p>
428 492The <b><uri link="quick-samba-howto.xml">Quick SAMBA Howto</uri></b> gives you a
493step-by-step introduction to Samba and includes instructions on setting up an
494anti-virus checking for the Samba shares.
429<p> 495</p>
430The <b><uri link="guide-localization.xml">Localisation Guide</uri></b> explains how 496
431to localise Gentoo Linux for non-English users.
432</p> 497<p>
433 498The <b><uri link="home-router-howto.xml">Home Router Howto</uri></b> teaches you how to
434<p> 499turn any Gentoo machine into a router for a small network. Perfect for turning an old
435The <b><uri link="dri-howto.xml">Direct Rendering Howto</uri></b> explains how to get 500computer in your home into a useful firewall/router/etc...
4363D acceleration working using XFree-DRM.
437</p>
438
439<p>
440The <b><uri link="ati-faq.xml">ATI FAQ</uri></b> provides the answers to frequently
441asked questions regarding ATI graphical cards.
442</p>
443
444</body>
445</section>
446<section>
447<title>Application Specific Documentation</title>
448<body>
449
450<p>
451The <b><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></b> leads by example
452to explain the basics of Nano.
453</p>
454
455<p>
456The <b><uri link="vi-guide.xml">Vi Guide</uri></b> uses the cheatsheet method to
457teach the basics of vi.
458</p>
459
460<p>
461The <b><uri link="gnupg-user.xml">GnuPG User Guide</uri></b> is the definitive guide
462on GnuPG.
463</p>
464
465<p>
466The <b><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></b>
467explains how to use fetchmail, procmail, mutt, and nbsmtp.
468</p>
469
470<p>
471The <b><uri link="cvs-tutorial.xml">CVS Tutorial</uri></b> documents the basics of
472using CVS, the Concurrent Versioning System.
473</p> 501</p>
474 502
475</body> 503</body>
476</section> 504</section>
477</chapter> 505</chapter>
481<section> 509<section>
482<title>Introduction</title> 510<title>Introduction</title>
483<body> 511<body>
484 512
485<p> 513<p>
486Gentoo is a volunteer-driven distribution. It is therefor vital to have 514Gentoo is a volunteer-driven distribution. It is therefore vital to have
487high-quality development-related documentation available so that interested 515high-quality development-related documentation available so that interested
488users can easily learn how to help in the development of their favorite 516users can easily learn how to help in the development of their favorite
489distribution. 517distribution.
490</p> 518</p>
491 519
492</body> 520</body>
493</section> 521</section>
494<section> 522<section>
523<title>Gentoo Developer Handbook</title>
524<body>
525
526<p>
527All developer-specific documentation, including but not limited to Ebuild and
528Eclass development, policies and such, has now been bundled in one awsome <b>
529<uri link="/proj/en/devrel/handbook/handbook.xml">Gentoo Developer
530Handbook</uri></b> for your reading pleasure.
531</p>
532
533</body>
534</section>
535<section>
495<title>Gentoo Development Policies</title> 536<title>Gentoo Development Policies</title>
496<body> 537<body>
497 538
498<p> 539<p>
499The <b><uri link="policy.xml">Gentoo Linux Development Policy</uri></b> details
500current policy for the creation of ebuilds.
501</p>
502
503<p>
504The <b><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></b>
505details current policy for Gentoo Linux releases.
506</p>
507
508<p>
509The <b><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></b> details 540The <b><uri link="/proj/en/gdp/doc/doc-policy.xml">Gentoo Linux Documentation Policy</uri></b>
510current policy for the creation and editing of documentation. 541details current policy for the creation and editing of documentation.
511</p> 542</p>
512 543
513</body> 544</body>
514</section> 545</section>
515<section> 546<section>
516<title>Development Related Documentation</title> 547<title>Development Related Documentation</title>
517<body> 548<body>
518 549
519<p> 550<p>
520The <b><uri link="gentoo-howto.xml">Ebuild HOWTO</uri></b> explains how to create
521ebuilds.
522</p>
523
524<p>
525The <b><uri link="eclass-howto.xml">Eclass HOWTO</uri></b> shows how to create
526ebuilds that support OOP-like inheritance features.
527</p>
528
529<p>
530The <b><uri link="stage-building-guide.xml">Stage Building Guide</uri></b> details
531the stage tarball creation process.
532</p>
533
534<p>
535The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b> explains 551The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b>
536how to submit user-authored ebuilds. 552explains how to submit user-authored ebuilds.
537</p>
538
539<p> 553</p>
554
555<p>
540The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML format 556The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML
541used in Gentoo Linux's web-based documentation. 557format used in Gentoo Linux's web-based documentation.
558</p>
559
560<p>
561The <b><uri link="/proj/en/gdp/doc/doc-tipsntricks.xml">Doc Developers' Tips
562&amp; Tricks</uri></b> contains some pointers for documentation developers.
563</p>
564
565<p>
566The <b><uri link="cvs-tutorial.xml">CVS Tutorial</uri></b> documents the basics
567of using CVS, the Concurrent Versioning System.
542</p> 568</p>
543 569
544</body> 570</body>
545</section> 571</section>
546</chapter> 572</chapter>
562</ul> 588</ul>
563 589
564</body> 590</body>
565</section> 591</section>
566</chapter> 592</chapter>
593<chapter>
594<title>Document Listing</title>
595<section>
596<body>
597
598<p>
599For people who like to get a short overview on available documentation, here it
600is :)
601</p>
602
603<table>
604<tr><th>Frequently Asked Questions</th></tr>
605<tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr>
606<tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr>
607<tr><ti><uri link="gentoo-sparc-faq.xml">Gentoo SPARC FAQ</uri></ti></tr>
608<tr><th>Installation Related Documentation</th></tr>
609<tr><ti><uri link="handbook/">Gentoo Handbook</uri></ti></tr>
610<tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Reference</uri></ti></tr>
611<tr><ti><uri link="gentoo-sparc-quickinstall.xml">Gentoo sparc Quick Installation Reference</uri></ti></tr>
612<tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr>
613<tr><ti><uri link="/proj/en/base/amd64/technotes.xml">AMD64 Technotes</uri></ti></tr>
614<tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr>
615<tr><ti><uri link="lvm2.xml">LVM2 Guide</uri></ti></tr>
616<tr><ti><uri link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Tips 'n Tricks Document</uri></ti></tr>
617<tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr>
618<tr><ti><uri link="gentoo-upgrading.xml">Gentoo Upgrading Howto</uri></ti></tr>
619<tr><ti><uri link="genkernel.xml">Genkernel Guide</uri></ti></tr>
620<tr><ti><uri link="colinux-howto.xml">coLinux Howto</uri></ti></tr>
621<tr><th>Gentoo System Documentation</th></tr>
622<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and Software</uri></ti></tr>
623<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=3">Portage Features</uri></ti></tr>
624<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=4">Controlling Portage Behaviour</uri></ti></tr>
625<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></ti></tr>
626<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment Variables</uri></ti></tr>
627<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></ti></tr>
628<tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr>
629<tr><ti><uri link="gentoolkit.xml">Gentoolkit Guide</uri></ti></tr>
630<tr><ti><uri link="macos-guide.xml">Gentoo for Mac OS X</uri></ti></tr>
631<tr><th>System Administration Documentation</th></tr>
632<tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr>
633<tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr>
634<tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr>
635<tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr>
636<!-- <tr><ti><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></ti></tr>
637-->
638<!-- <tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> -->
639<tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr>
640<tr><ti><uri link="diskless-howto.xml">Diskless Guide</uri></ti></tr>
641<tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr>
642<tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr>
643<tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr>
644<tr><ti><uri link="udev-guide.xml">Gentoo udev Guide</uri></ti></tr>
645<tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr>
646<tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr>
647<tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></ti></tr>
648<tr><ti><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></ti></tr>
649<tr><ti><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot Howto</uri></ti></tr>
650<tr><ti><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM Reference Guide</uri></ti></tr>
651<tr><ti><uri link="quick-samba-howto.xml">Quick Samba Howto</uri></ti></tr>
652<tr><ti><uri link="home-router-howto.xml">Home Router Howto</uri></ti></tr>
653<tr><th>Gentoo Development Documentation</th></tr>
654<tr><ti><uri link="/proj/en/devrel/handbook/handbook.xml">Gentoo Developer Handbook</uri></ti></tr>
655<tr><ti><uri link="policy.xml">Gentoo Linux Development Policy</uri></ti></tr>
656<!-- <tr><ti><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></ti></tr> -->
657<tr><ti><uri link="/proj/en/gdp/doc/doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr>
658<tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr>
659<tr><ti><uri link="xml-guide.xml">GuideXML Guide</uri></ti></tr>
660<tr><ti><uri link="/proj/en/gdp/doc/doc-tipsntricks.xml">Doc Developers' Tips &amp; Tricks</uri></ti></tr>
661<tr><ti><uri link="cvs-tutorial.xml">CVS Tutorial</uri></ti></tr>
662<tr><th>Other Documentation</th></tr>
663<tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr>
664<tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr>
665</table>
666
667</body>
668</section>
669</chapter>
567</mainpage> 670</mainpage>

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

  ViewVC Help
Powered by ViewVC 1.1.20