/[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.8 Revision 1.65
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.65 2004/07/20 17:12:29 vapier 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>
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>2.3</version> 19<version>2.30</version>
19 <date>November 6, 2003</date> 20<date>May 12, 2004</date>
20 21
21<chapter> 22<chapter>
22<title>Gentoo Documentation Resources</title> 23<title>Gentoo Documentation Resources</title>
23<section> 24<section>
24<title>Available Languages</title> 25<title>Available Languages</title>
27<p> 28<p>
28This page (and documentation) is available in the following languages: 29This page (and documentation) is available in the following languages:
29</p> 30</p>
30 31
31<p> 32<p>
33<uri link="http://www.gentoo.org/doc/da/index.xml">Danish</uri> |
32<uri link="http://www.gentoo.org/doc/nl/index.xml">Dutch</uri> | 34<uri link="http://www.gentoo.org/doc/nl/index.xml">Dutch</uri> |
33<uri link="http://www.gentoo.org/doc/en/index.xml">English</uri> | 35<uri link="http://www.gentoo.org/doc/en/index.xml">English</uri> |
34<uri link="http://www.gentoo.org/doc/fr/index.xml">French</uri> | 36<uri link="http://www.gentoo.org/doc/fr/index.xml">French</uri> |
35<uri link="http://www.gentoo.org/doc/de/index.xml">German</uri> | 37<uri link="http://www.gentoo.org/doc/de/index.xml">German</uri> |
36<uri link="http://www.gentoo.org/doc/hu/index.xml">Hungarian</uri> | 38<uri link="http://www.gentoo.org/doc/hu/index.xml">Hungarian</uri> |
37<uri link="http://www.gentoo.org/doc/id/index.xml">Indonesian</uri> | 39<uri link="http://www.gentoo.org/doc/id/index.xml">Indonesian</uri> |
38<uri link="http://www.gentoo.org/doc/it/index.xml">Italian</uri> | 40<uri link="http://www.gentoo.org/doc/it/index.xml">Italian</uri> |
39<uri link="http://www.gentoo.org/doc/ja/index.xml">Japanese</uri> | 41<uri link="http://www.gentoo.org/doc/ja/index.xml">Japanese</uri> |
40<uri link="http://www.gentoo.org/doc/kr/index.xml">Korean</uri> | 42<!-- <uri link="http://www.gentoo.org/doc/kr/index.xml">Korean</uri> | -->
41<uri link="http://www.gentoo.org/doc/ru/index.xml">Russian</uri> | 43<uri link="http://www.gentoo.org/doc/ru/index.xml">Russian</uri> |
42<uri link="http://www.gentoo.org/doc/es/index.xml">Spanish</uri> | 44<uri link="http://www.gentoo.org/doc/es/index.xml">Spanish</uri> |
43<uri link="http://www.gentoo.org/doc/tw/index.xml">Traditional Chinese</uri> 45<uri link="http://www.gentoo.org/doc/tw/index.xml">Traditional Chinese</uri>
44</p> 46</p>
45 47
77</p> 79</p>
78 80
79<p> 81<p>
80If 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
81<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
82a bug report for "Docs-developer" or "Docs-user". These bugreports will 84a bug report for "Docs-developer" or "Docs-user". These bug reports will
83then be handled by the <uri 85then be handled by the <uri
84link="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation 86link="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation
85Project</uri>. 87Project</uri>.
86</p> 88</p>
87 89
94<p> 96<p>
95Our documentation is available in several languages. Although not all 97Our documentation is available in several languages. Although not all
96documents 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
97provide our users with as much translated documentation as possible. If 99provide our users with as much translated documentation as possible. If
98you want to help with our translation efforts, please contact <mail 100you want to help with our translation efforts, please contact <mail
99link="svyatogor@gentoo.org">Sergey Kuleshov</mail> who is in charge of 101link="neysx@gentoo.org">Xavier Neys</mail> who is in charge of
100the internationalisation efforts. 102the internationalisation efforts.
101</p> 103</p>
102 104
103</body> 105</body>
104</section> 106</section>
106<title>Frequently Asked Questions</title> 108<title>Frequently Asked Questions</title>
107<body> 109<body>
108 110
109<p> 111<p>
110As 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
111two official FAQs maintained by the Gentoo Documentation Project: 113a couple of official FAQs maintained by the Gentoo Documentation Project:
112</p> 114</p>
113 115
114<ul> 116<ul>
115<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
116about Gentoo Linux with focus on x86 platforms.</li> 118about Gentoo Linux with focus on x86 platforms.</li>
117<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
118Asked 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>
119</ul> 123</ul>
120 124
121<p> 125<p>
122Furthermore we have a very extensive collection of FAQs on our <uri 126Furthermore we have a very extensive collection of FAQs on our <uri
123link="http://forums.gentoo.org">forums</uri>. To view those, go to 127link="http://forums.gentoo.org">forums</uri>. To view those, go to
130<title>Gentoo Handbook</title> 134<title>Gentoo Handbook</title>
131<body> 135<body>
132 136
133<p> 137<p>
134The Gentoo Documentation Project has started with the <uri 138The Gentoo Documentation Project has started with the <uri
135link="handbook/handbook.xml">Gentoo Handbook</uri> development. Currently, the 139link="handbook/">Gentoo Handbook</uri> development. Currently, the
136first part on <uri link="handbook/handbook.xml?part=1">Installing Gentoo</uri> 140first two parts (<uri link="handbook/handbook-x86.xml?part=1">Installing
137is finished and has now reached the "testing" stage. Users are encouraged to try 141Gentoo</uri> and <uri link="handbook/handbook-x86.xml?part=2">Working with
138these installation instructions and <uri 142Gentoo</uri>) are finished and have reached the "official" stage. Users are
143encouraged to use the installation instructions from the Handbook and <uri
139link="http://bugs.gentoo.org/enter_bug.cgi?product=Docs-user">bug</uri> us with 144link="http://bugs.gentoo.org/enter_bug.cgi?product=Docs-user">bug</uri> us with
140their experience (please use the <e>Handbook</e> component). 145their experience (please use the <e>Handbook</e> component).
141</p> 146</p>
142 147
143<p> 148<p>
144More information can be found on the <uri link="handbook/index.xml">Gentoo 149More information can be found on the <uri link="handbook/">Gentoo
145Handbook Effort</uri> homepage. 150Handbook Effort</uri> homepage.
146</p> 151</p>
147 152
148</body> 153</body>
149</section> 154</section>
154<section> 159<section>
155<title>Introduction</title> 160<title>Introduction</title>
156<body> 161<body>
157 162
158<p> 163<p>
159The installation related documentation provide information that can be usefull 164The installation related documentation provides information that can be useful
160during the installation of Gentoo Linux. This includes architecture-related 165during the installation of Gentoo Linux. This includes the part on "Installing
161installation resources and tutorials that are to be followed during the 166Gentoo" in our Gentoo Handbook, as well as the older but still maintained
162installation (such as LVM). 167architecture-related installation resources and tutorials that are to be
168followed during the installation.
163</p> 169</p>
164 170
165</body> 171</body>
166</section> 172</section>
167<section> 173<section>
168<title>Installation Guides</title> 174<title>Installation Guides</title>
169<body> 175<body>
170 176
171<p> 177<p>
172The installation guides step you through the process of installing Gentoo 178The first part of our <b><uri link="/doc/en/handbook/index.xml">Gentoo
173Linux 1.4. We support various installation approaches, depending on how much 179Handbook</uri></b> explains how to install Gentoo on your system. Each
174of the system you want to custom-build from scratch. 180architecture-specific version contains instructions for all users.
175</p>
176
177<p> 181</p>
178The installation guides are available for the following architectures: 182
179</p> 183<p>
180 184For experienced users we also have Quick Installation Reference documents:
181<table>
182<tr>
183 <ti>x86</ti>
184 <ti><b><uri link="gentoo-x86-install.xml">Online</uri></b></ti>
185 <ti><b><uri link="gentoo-x86-install.xml?style=printable">Printer Friendly</uri></b></ti>
186</tr>
187<tr>
188 <ti>Alpha</ti>
189 <ti><b><uri link="gentoo-alpha-install.xml">Online</uri></b></ti>
190 <ti><b><uri link="gentoo-alpha-install.xml?style=printable">Printer Friendly</uri></b></ti>
191</tr>
192<tr>
193 <ti>HPPA</ti>
194 <ti><b><uri link="gentoo-hppa-install.xml">Online</uri></b></ti>
195 <ti><b><uri link="gentoo-hppa-install.xml?style=printable">Printer Friendly</uri></b></ti>
196</tr>
197<tr>
198 <ti>PPC</ti>
199 <ti><b><uri link="gentoo-ppc-install.xml">Online</uri></b></ti>
200 <ti><b><uri link="gentoo-ppc-install.xml?style=printable">Printer Friendly</uri></b></ti>
201</tr>
202<tr>
203 <ti>Sparc</ti>
204 <ti><b><uri link="gentoo-sparc-install.xml">Online</uri></b></ti>
205 <ti><b><uri link="gentoo-sparc-install.xml?style=printable">Printer Friendly</uri></b></ti>
206</tr>
207</table>
208
209<p> 185</p>
210Most users will probably need the <b><uri link="gentoo-x86-install.xml">x86 186
211Installation Guide</uri></b>. For experienced users we also have a <b><uri 187<ul>
212link="gentoo-x86-quickinstall.xml">x86 Quick Installation Reference</uri></b>. 188 <li><b><uri link="gentoo-x86-quickinstall.xml">x86 Quick Installation Reference</uri></b></li>
213</p> 189 <li><b><uri link="gentoo-sparc-quickinstall.xml">Sparc Quick Installation Reference</uri></b></li>
190</ul>
214 191
215<p> 192<p>
216Alpha-users are probably also interested in our <b><uri 193Alpha-users are probably also interested in our <b><uri
217link="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
218explains 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.
231Installation Guide</uri></b> which lists the installation steps needed to install 208Installation Guide</uri></b> which lists the installation steps needed to install
232Gentoo from another medium (distribution, bootable CD, network boot, etc.). 209Gentoo from another medium (distribution, bootable CD, network boot, etc.).
233</p> 210</p>
234 211
235<p> 212<p>
236Users interested in using LVM should read up our <b><uri link="lvm.xml">LVM 213Users interested in using LVM2 should read up our <b><uri link="lvm2.xml">LVM2
237Guide</uri></b> which explains what steps you have to go through to get your 214Guide</uri></b> which explains the steps required to get your LVM2 scheme up
238LVM scheme up and running. 215and running.
216</p>
217
218<p>
219As our installation instructions allow for great flexibility, there are many
220tips and tricks that can be persued during the installation. We have a <b><uri
221link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Installation Tips 'n
222Tricks</uri></b> document online (which also contains interesting Tips 'n Tricks
223for other architectures).
239</p> 224</p>
240 225
241<p> 226<p>
242The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade 227The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade
243Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to 228Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to
244Gentoo Linux 1.4. 229Gentoo Linux 1.4.
245</p> 230</p>
246 231
232<p>
233The <b><uri link="gentoo-upgrading.xml">Gentoo Upgrading Guide</uri></b> goes
234deeper into the motivation behind the easy-upgrading system Gentoo uses and
235provides more information about the so-called "profiles".
236</p>
237
238<p>
239The <b><uri link="genkernel.xml">Genkernel Guide</uri></b> intends to provide a
240reference of all the functions provided by genkernel.
241</p>
242
243<p>
244With the help of our <b><uri link="colinux-howto.xml">coLinux HOWTO</uri></b>
245you are able to run Gentoo from within Windows.
246</p>
247
247</body> 248</body>
248</section> 249</section>
249</chapter> 250</chapter>
250 251
251<chapter> 252<chapter>
257<p> 258<p>
258The Gentoo System Documentation contains several guides about what makes 259The Gentoo System Documentation contains several guides about what makes
259Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc. 260Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc.
260</p> 261</p>
261 262
263<p>
264The Gentoo Handbook has a part on <uri
265link="handbook/handbook-x86.xml?part=2">Working with Gentoo</uri> which contains
266information on Portage, USE flags, the Gentoo Init system and environment
267variables.
268</p>
269
262</body> 270</body>
263</section> 271</section>
264<section> 272<section>
265<title>Portage and Related Documentation</title> 273<title>Portage and Related Documentation</title>
266<body> 274<body>
267 275
268<p> 276<p>
269The <b><uri link="portage-user.xml">Portage User Guide</uri></b> briefly covers how 277The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and
278Software</uri></b> chapter in the Gentoo Handbook briefly covers how to keep
270to keep your packages up to date and how to maintain your installed software. 279your packages up to date and how to maintain your installed software. In other
271In other words: this guide tells you how to use <c>emerge</c>. 280words, this chapter tells you how to use <c>emerge</c>.
272</p> 281</p>
282
273 283
274<p> 284<p>
275The <b><uri link="portage-manual.xml">Portage Manual</uri></b> provides a general 285The <b><uri link="portage-manual.xml">Portage Manual</uri></b> provides a general
276overview of Portage, detailed configuration information and an end user guide 286overview of Portage, detailed configuration information and an end user guide
277to installing and maintaining packages using the Portage system. It is 287to installing and maintaining packages using the Portage system. It is
278far more extended than the Portage User Guide. 288far more extended than the Portage User Guide.
279</p> 289</p>
280 290
281<p> 291<p>
282The <b><uri link="use-howto.xml">USE Howto</uri></b> introduces you to the ultimate 292The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></b>
293chapter in the Gentoo Handbook introduces you to the ultimate
283tool for customizing Gentoo -- USE flags. This howto helps you decide which 294tool for customizing Gentoo -- USE flags. This howto helps you decide which
284USE flags you need. It also describes the use of <c>etcat</c> to receive 295USE flags you need. It also describes the use of <c>etcat</c> to receive
285more verbose information regarding USE-flags on a package. 296more verbose information regarding USE-flags on a package.
286</p> 297</p>
287 298
290<section> 301<section>
291<title>Configuring Gentoo</title> 302<title>Configuring Gentoo</title>
292<body> 303<body>
293 304
294<p> 305<p>
295The <b><uri link="env.d-howto.xml">ENV.D Howto</uri></b> explains how to manage 306The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment
307Variables</uri></b> chapter in the Gentoo Handbook explains how to manage
296environment variables (such as <path>$PATH</path>) and the dynamic linker 308environment variables (such as <path>$PATH</path>) and the dynamic linker
297cache easily. 309cache easily.
298</p> 310</p>
299 311
300<p> 312<p>
301The <b><uri link="rc-scripts.xml">RC-Script Guide</uri></b> details our system 313The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></b>
314chapter in the Gentoo Handbook details our system
302startup and service management scripts. Besides the regular 315startup and service management scripts. Besides the regular
303initscript-related items it also covers initscript dependencies and 316initscript-related items it also covers initscript dependencies and
304support for virtuals. 317support for virtuals.
305</p> 318</p>
306 319
360Gentoo Linux. IPv6 is the next Internet Protocol and is gaining 373Gentoo Linux. IPv6 is the next Internet Protocol and is gaining
361popularity widely. 374popularity widely.
362</p> 375</p>
363 376
364<p> 377<p>
365The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use User-Mode 378The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use
366Linux under Gentoo Linux. User Mode Linux (UML) provides a nice feature 379User-Mode Linux under Gentoo Linux. User Mode Linux (UML) provides a nice
367for Linux: Running Linux inside Linux (inside Linux inside Linux ...). 380feature for Linux: Running Linux inside Linux (inside Linux inside Linux ...).
368With UML, you can easily create virtual setups. 381With UML, you can easily create virtual setups.
369</p> 382</p>
370 383
384<!--
385<p>
386The <b><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></b> show you
387how to set up a UML installation with SELinux support.
388</p>
389-->
390
371</body> 391</body>
372</section> 392</section>
373<section> 393<section>
374<title>Specific Administration Guides</title> 394<title>Specific Administration Guides</title>
375<body> 395<body>
376 396
397<!-- Some possible security issues, see #39718
377<p> 398<p>
378The <b><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></b> explains how 399The <b><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></b> explains how
379to administer user accounts centralised using OpenLDAP. 400to administer user accounts centralised using OpenLDAP.
380</p> 401</p>
402-->
381 403
382<p> 404<p>
383The <b><uri link="openmosix-howto.xml">OpenMosix Howto</uri></b> describes step by 405The <b><uri link="openmosix-howto.xml">OpenMosix Howto</uri></b> describes step by
384step how you can create a farm full of diskless openmosix nodes (a 406step how you can create a farm of openmosix nodes (a cluster of several PCs).
385cluster of several PCs). 407</p>
408
409<p>
410The <b><uri link="diskless-howto.xml">Diskless Howto</uri></b> describes step by
411step how you can set up diskless nodes with Gentoo.
386</p> 412</p>
387 413
388<p> 414<p>
389The <b><uri link="ltsp.xml">LTSP Guide</uri></b> explains how to setup a Linux 415The <b><uri link="ltsp.xml">LTSP Guide</uri></b> explains how to setup a Linux
390Terminal Server with Gentoo. 416Terminal Server with Gentoo.
399The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works 425The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works
400and how to administer it. 426and how to administer it.
401</p> 427</p>
402 428
403<p> 429<p>
430The <b><uri link="udev-guide.xml">Gentoo udev Guide</uri></b> describes the new
431device file management (using udev) which replaces DevFS and informs the reader
432how udev is integrated in Gentoo.
433</p>
434
435<p>
404The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive 436The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive
405guide to Gentoo and printing. 437guide to Gentoo and printing.
406</p> 438</p>
407 439
408<p> 440<p>
409The <b><uri link="openafs.xml">OpenAFS Guide</uri></b> documents the use and 441The <b><uri link="openafs.xml">OpenAFS Guide</uri></b> documents the use and
410installation of OpenAFS, a distributed network-based file sharing technology. 442installation of OpenAFS, a distributed network-based file sharing technology.
411</p> 443</p>
412 444
413<p> 445<p>
414The <b><uri link="virt-mail-howto.xml">Virtual/Mailhost Howto</uri></b> is the 446The <b><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></b> is
415essential guide for any mail administrator. It covers the use of MySQL for 447the essential guide for any postfix mail administrator. It covers the use of MySQL
416virtual users, webbased e-mail software, mailinglist software etc. 448for virtual users, webbased e-mail software, mailinglist software etc.
449</p>
450
451<p>
452The <b><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></b> is a pretty
453useful guide for running a qmail based mail system. It focuses on remote
454access and encrypted communication.
455</p>
456
457<p>
458The <b><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot
459HOWTO</uri></b> describes how to setup a network booting environment for a Sun
460Microsystems SPARC or UltraSPARC based computer.
461</p>
462
463<p>
464 The <b><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM reference
465Guide</uri></b> offers a guide to the SPARC OpenBoot system, available on all
466Sun Microsytsms SPARC/UltraSparc based computers.
467</p>
468
469<p>
470The <b><uri link="quick-samba-howto.xml">Quick SAMBA Howto</uri></b> gives you a
471step-by-step introduction to Samba and includes instructions on setting up an
472anti-virus checking for the Samba shares.
417</p> 473</p>
418 474
419</body> 475</body>
420</section> 476</section>
421</chapter> 477</chapter>
468<p> 524<p>
469The <b><uri link="ati-faq.xml">ATI FAQ</uri></b> provides the answers to frequently 525The <b><uri link="ati-faq.xml">ATI FAQ</uri></b> provides the answers to frequently
470asked questions regarding ATI graphical cards. 526asked questions regarding ATI graphical cards.
471</p> 527</p>
472 528
529<p>
530The <b><uri link="xorg-config.xml">XOrg Configuration HOWTO</uri></b> talks
531about the installation and configuration of X.org.
532</p>
533
534<p>
535The <b><uri link="kde-config.xml">KDE Configuration HOWTO</uri></b> talks about
536the installation and configuration of KDE.
537</p>
538
539<p>
540The <b><uri link="gnome-config.xml">GNOME Configuration HOWTO</uri></b> talks
541about the installation and configuration of GNOME.
542</p>
543
473</body> 544</body>
474</section> 545</section>
475<section> 546<section>
476<title>Application Specific Documentation</title> 547<title>Application Specific Documentation</title>
477<body> 548<body>
510<section> 581<section>
511<title>Introduction</title> 582<title>Introduction</title>
512<body> 583<body>
513 584
514<p> 585<p>
515Gentoo is a volunteer-driven distribution. It is therefor vital to have 586Gentoo is a volunteer-driven distribution. It is therefore vital to have
516high-quality development-related documentation available so that interested 587high-quality development-related documentation available so that interested
517users can easily learn how to help in the development of their favorite 588users can easily learn how to help in the development of their favorite
518distribution. 589distribution.
519</p> 590</p>
520 591
527<p> 598<p>
528The <b><uri link="policy.xml">Gentoo Linux Development Policy</uri></b> details 599The <b><uri link="policy.xml">Gentoo Linux Development Policy</uri></b> details
529current policy for the creation of ebuilds. 600current policy for the creation of ebuilds.
530</p> 601</p>
531 602
603<!--
532<p> 604<p>
533The <b><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></b> 605The <b><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></b>
534details current policy for Gentoo Linux releases. 606details current policy for Gentoo Linux releases.
535</p> 607</p>
608-->
536 609
537<p> 610<p>
538The <b><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></b> details 611The <b><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></b>
539current policy for the creation and editing of documentation. 612details current policy for the creation and editing of documentation.
540</p> 613</p>
541 614
542</body> 615</body>
543</section> 616</section>
544<section> 617<section>
545<title>Development Related Documentation</title> 618<title>Development Related Documentation</title>
546<body> 619<body>
547 620
548<p> 621<p>
549The <b><uri link="gentoo-howto.xml">Ebuild HOWTO</uri></b> explains how to create 622The <b><uri link="gentoo-howto.xml">Ebuild HOWTO</uri></b> explains how to
550ebuilds. 623create ebuilds.
551</p> 624</p>
552 625
553<p> 626<p>
554The <b><uri link="eclass-howto.xml">Eclass HOWTO</uri></b> shows how to create 627The <b><uri link="eclass-howto.xml">Eclass HOWTO</uri></b> shows how to create
555ebuilds that support OOP-like inheritance features. 628ebuilds that support OOP-like inheritance features.
556</p> 629</p>
557 630
558<p> 631<p>
559The <b><uri link="stage-building-guide.xml">Stage Building Guide</uri></b> details
560the stage tarball creation process.
561</p>
562
563<p>
564The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b> explains 632The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b>
565how to submit user-authored ebuilds. 633explains how to submit user-authored ebuilds.
566</p>
567
568<p> 634</p>
635
636<p>
637The <b><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></b>
638lists the common mistakes contributors/developers make when trying to submit an
639ebuild.
640</p>
641
642<p>
643The <b><uri link="metadata.xml">Metadata document</uri></b> explains how to
644write up a <path>metadata.xml</path> file for a package.
645</p>
646
647<p>
569The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML format 648The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML
570used in Gentoo Linux's web-based documentation. 649format used in Gentoo Linux's web-based documentation.
650</p>
651
652<p>
653The <b><uri link="doc-tipsntricks.xml">Doc Developers' Tips &amp;
654Tricks</uri></b> contains some pointers for documentation developers.
571</p> 655</p>
572 656
573</body> 657</body>
574</section> 658</section>
575</chapter> 659</chapter>
593</body> 677</body>
594</section> 678</section>
595</chapter> 679</chapter>
596<chapter> 680<chapter>
597<title>Document Listing</title> 681<title>Document Listing</title>
682<section>
598<body> 683<body>
599 684
600<p> 685<p>
601For people who like to get a short overview on available documentation, here it 686For people who like to get a short overview on available documentation, here it
602is :) 687is :)
604 689
605<table> 690<table>
606<tr><th>Frequently Asked Questions</th></tr> 691<tr><th>Frequently Asked Questions</th></tr>
607<tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr> 692<tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr>
608<tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr> 693<tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr>
694<tr><ti><uri link="gentoo-sparc-faq.xml">Gentoo SPARC FAQ</uri></ti></tr>
609<tr><th>Installation Related Documentation</th></tr> 695<tr><th>Installation Related Documentation</th></tr>
610<tr><ti><uri link="gentoo-x86-install.xml">Gentoo x86 Installation Guide</uri></ti></tr> 696<tr><ti><uri link="handbook/">Gentoo Handbook</uri></ti></tr>
611<tr><ti><uri link="gentoo-alpha-install.xml">Gentoo Alpha Installation Guide</uri></ti></tr>
612<tr><ti><uri link="gentoo-hppa-install.xml">Gentoo HPPA Installation Guide</uri></ti></tr>
613<tr><ti><uri link="gentoo-ppc-install.xml">Gentoo PPC Installation Guide</uri></ti></tr>
614<tr><ti><uri link="gentoo-sparc-install.xml">Gentoo SPARC Installation Guide</uri></ti></tr>
615<tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Rerefence</uri></ti></tr> 697<tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Rerefence</uri></ti></tr>
698<tr><ti><uri link="gentoo-sparc-quickinstall.xml">Gentoo sparc Quick Installation Rerefence</uri></ti></tr>
616<tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr> 699<tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr>
617<tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr> 700<tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr>
618<tr><ti><uri link="lvm.xml">LVM Guide</uri></ti></tr> 701<tr><ti><uri link="lvm2.xml">LVM2 Guide</uri></ti></tr>
702<tr><ti><uri link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Tips 'n Tricks Document</uri></ti></tr>
619<tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr> 703<tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr>
704<tr><ti><uri link="gentoo-upgrading.xml">Gentoo Upgrading HOWTO</uri></ti></tr>
705<tr><ti><uri link="genkernel.xml">Genkernel Guide</uri></ti></tr>
706<tr><ti><uri link="colinux-howto.xml">coLinux HOWTO</uri></ti></tr>
620<tr><th>Gentoo System Documentation</th></tr> 707<tr><th>Gentoo System Documentation</th></tr>
621<tr><ti><uri link="portage-user.xml">Portage User Guide</uri></ti></tr> 708<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and Software</uri></ti></tr>
622<tr><ti><uri link="portage-manual.xml">Portage Manual Guide</uri></ti></tr> 709<tr><ti><uri link="portage-manual.xml">Portage Manual Guide</uri></ti></tr>
623<tr><ti><uri link="use-howto.xml">USE Howto</uri></ti></tr> 710<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></ti></tr>
624<tr><ti><uri link="env.d-howto.xml">ENV.D Howto</uri></ti></tr> 711<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment Variables</uri></ti></tr>
625<tr><ti><uri link="rc-scripts.xml">RC-Script Guide</uri></ti></tr> 712<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></ti></tr>
626<tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr> 713<tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr>
627<tr><th>System Administration Documentation</th></tr> 714<tr><th>System Administration Documentation</th></tr>
628<tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr> 715<tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr>
629<tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr> 716<tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr>
630<tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr> 717<tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr>
631<tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr> 718<tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr>
719<!-- <tr><ti><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></ti></tr>
720-->
632<tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> 721<!-- <tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> -->
633<tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr> 722<tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr>
723<tr><ti><uri link="diskless-howto.xml">Diskless Guide</uri></ti></tr>
634<tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr> 724<tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr>
635<tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr> 725<tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr>
636<tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr> 726<tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr>
727<tr><ti><uri link="udev-guide.xml">Gentoo udev Guide</uri></ti></tr>
637<tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr> 728<tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr>
638<tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr> 729<tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr>
639<tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Howto</uri></ti></tr> 730<tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></ti></tr>
731<tr><ti><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></ti></tr>
732<tr><ti><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot Howto</uri></ti></tr>
733<tr><ti><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM Reference Guide</uri></ti></tr>
734<tr><ti><uri link="quick-samba-howto.xml">Quick Samba HOWTO</uri></ti></tr>
640<tr><th>Desktop Related Documentation</th></tr> 735<tr><th>Desktop Related Documentation</th></tr>
641<tr><ti><uri link="desktop.xml">Desktop Configuration Guide</uri></ti></tr> 736<tr><ti><uri link="desktop.xml">Desktop Configuration Guide</uri></ti></tr>
642<tr><ti><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></ti></tr> 737<tr><ti><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></ti></tr>
643<tr><ti><uri link="java.xml">Java Guide</uri></ti></tr> 738<tr><ti><uri link="java.xml">Java Guide</uri></ti></tr>
644<tr><ti><uri link="guide-localization.xml">Localisation Guide</uri></ti></tr> 739<tr><ti><uri link="guide-localization.xml">Localisation Guide</uri></ti></tr>
645<tr><ti><uri link="dri-howto.xml">Direct Rendering Howto</uri></ti></tr> 740<tr><ti><uri link="dri-howto.xml">Direct Rendering Howto</uri></ti></tr>
646<tr><ti><uri link="ati-faq.xml">ATI FAQ</uri></ti></tr> 741<tr><ti><uri link="ati-faq.xml">ATI FAQ</uri></ti></tr>
742<tr><ti><uri link="xorg-config.xml">XOrg Configuration HOWTO</uri></ti></tr>
743<tr><ti><uri link="kde-config.xml">KDE Configuration HOWTO</uri></ti></tr>
744<tr><ti><uri link="gnome-config.xml">GNOME Configuration HOWTO</uri></ti></tr>
647<tr><ti><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></ti></tr> 745<tr><ti><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></ti></tr>
648<tr><ti><uri link="vi-guide.xml">Vi Guide</uri></ti></tr> 746<tr><ti><uri link="vi-guide.xml">Vi Guide</uri></ti></tr>
747<tr><ti><uri link="gnupg-user.xml">GnuPG User Guide</uri></ti></tr>
649<tr><ti><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></ti></tr> 748<tr><ti><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></ti></tr>
650<tr><ti><uri link="cvs-tutorial.xml">CVS Tutorial</uri></ti></tr> 749<tr><ti><uri link="cvs-tutorial.xml">CVS Tutorial</uri></ti></tr>
651<tr><th>Gentoo Development Documentation</th></tr> 750<tr><th>Gentoo Development Documentation</th></tr>
652<tr><ti><uri link="policy.xml">Gentoo Linux Development Policy</uri></ti></tr> 751<tr><ti><uri link="policy.xml">Gentoo Linux Development Policy</uri></ti></tr>
653<tr><ti><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></ti></tr> 752<!-- <tr><ti><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></ti></tr> -->
654<tr><ti><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr> 753<tr><ti><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr>
655<tr><ti><uri link="gentoo-howto.xml">Ebuild Howto</uri></ti></tr> 754<tr><ti><uri link="gentoo-howto.xml">Ebuild Howto</uri></ti></tr>
656<tr><ti><uri link="eclass-howto.xml">Eclass Howto</uri></ti></tr> 755<tr><ti><uri link="eclass-howto.xml">Eclass Howto</uri></ti></tr>
657<tr><ti><uri link="stage-building-guide.xml">Stage Building Guide</uri></ti></tr>
658<tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr> 756<tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr>
757<tr><ti><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></ti></tr>
758<tr><ti><uri link="metadata.xml">Metadata document</uri></ti></tr>
759<tr><ti><uri link="xml-guide.xml">GuideXML Guide</uri></ti></tr>
760<tr><ti><uri link="doc-tipsntricks.xml">Doc Developers' Tips &amp; Tricks</uri></ti></tr>
659<tr><th>Other Documentation</th></tr> 761<tr><th>Other Documentation</th></tr>
660<tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr> 762<tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr>
661<tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr> 763<tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr>
662</table> 764</table>
663 765
664</body> 766</body>
767</section>
665</chapter> 768</chapter>
666</mainpage> 769</mainpage>

Legend:
Removed from v.1.8  
changed lines
  Added in v.1.65

  ViewVC Help
Powered by ViewVC 1.1.20