/[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.43 Revision 1.86
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.43 2004/03/06 17:27:14 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/index.xml,v 1.86 2004/11/09 22:05:05 neysx Exp $ -->
3<!DOCTYPE mainpage SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE mainpage SYSTEM "/dtd/guide.dtd">
4<mainpage id="docs"> 4<mainpage id="docs">
5 <title>Gentoo Documentation Resources</title> 5 <title>Gentoo Documentation Resources</title>
6 <author title="Author"> 6 <author title="Author">
7 <mail link="drobbins@gentoo.org">Daniel Robbins</mail> 7 <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
14 <mail link="peesh@gentoo.org">Jorge Paulo</mail> 14 <mail link="peesh@gentoo.org">Jorge Paulo</mail>
15 </author> 15 </author>
16 <author title="Editor"> 16 <author title="Editor">
17 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 17 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
18 </author> 18 </author>
19 <version>2.17</version> 19<version>2.41</version>
20 <date>March 6, 2004</date> 20<date>November 9, 2004</date>
21 21
22<chapter> 22<chapter>
23<title>Gentoo Documentation Resources</title> 23<title>Gentoo Documentation Resources</title>
24<section> 24<section>
25<title>Available Languages</title> 25<title>Available Languages</title>
40<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> |
41<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> |
42<!-- <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> | -->
43<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> |
44<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> |
45<uri link="http://www.gentoo.org/doc/tw/index.xml">Traditional Chinese</uri> 45<uri link="http://www.gentoo.org/doc/zh_tw/index.xml">Traditional Chinese</uri>
46</p> 46</p>
47 47
48</body> 48</body>
49</section> 49</section>
50<section> 50<section>
54<ul> 54<ul>
55<li><uri link="#doc_chap1">Introduction</uri></li> 55<li><uri link="#doc_chap1">Introduction</uri></li>
56<li><uri link="#doc_chap2">Installation Related Resources</uri></li> 56<li><uri link="#doc_chap2">Installation Related Resources</uri></li>
57<li><uri link="#doc_chap3">Gentoo System Documentation</uri></li> 57<li><uri link="#doc_chap3">Gentoo System Documentation</uri></li>
58<li><uri link="#doc_chap4">System Administration Documentation</uri></li> 58<li><uri link="#doc_chap4">System Administration Documentation</uri></li>
59<li><uri link="#doc_chap5">Desktop Related Documentation</uri></li> 59<li><uri link="desktop.xml">Gentoo Desktop Documentation Repository</uri></li>
60<li><uri link="#doc_chap6">Gentoo Development Documentation</uri></li> 60<li><uri link="#doc_chap5">Gentoo Development Documentation</uri></li>
61<li><uri link="#doc_chap7">Other Documentation</uri></li> 61<li><uri link="#doc_chap6">Other Documentation</uri></li>
62<li><uri link="#doc_chap8">Overview of Available Documentation</uri></li> 62<li><uri link="#doc_chap7">Overview of Available Documentation</uri></li>
63</ul> 63</ul>
64 64
65</body> 65</body>
66</section> 66</section>
67<section> 67<section>
108<title>Frequently Asked Questions</title> 108<title>Frequently Asked Questions</title>
109<body> 109<body>
110 110
111<p> 111<p>
112As 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
113two official FAQs maintained by the Gentoo Documentation Project: 113a couple of official FAQs maintained by the Gentoo Documentation Project:
114</p> 114</p>
115 115
116<ul> 116<ul>
117<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
118about Gentoo Linux with focus on x86 platforms.</li> 118about Gentoo Linux with focus on x86 platforms.</li>
119<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
120Asked 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>
121</ul> 123</ul>
122 124
123<p> 125<p>
124Furthermore we have a very extensive collection of FAQs on our <uri 126Furthermore we have a very extensive collection of FAQs on our <uri
125link="http://forums.gentoo.org">forums</uri>. To view those, go to 127link="http://forums.gentoo.org">forums</uri>. To view those, go to
132<title>Gentoo Handbook</title> 134<title>Gentoo Handbook</title>
133<body> 135<body>
134 136
135<p> 137<p>
136The Gentoo Documentation Project has started with the <uri 138The Gentoo Documentation Project has started with the <uri
137link="handbook/handbook.xml">Gentoo Handbook</uri> development. Currently, the 139link="handbook/">Gentoo Handbook</uri> development. Currently, the
138first two parts (<uri link="handbook/handbook.xml?part=1">Installing 140first two parts (<uri link="handbook/handbook-x86.xml?part=1">Installing
139Gentoo</uri> and <uri link="handbook/handbook.xml?part=2">Working with 141Gentoo</uri> and <uri link="handbook/handbook-x86.xml?part=2">Working with
140Gentoo</uri>) are finished and have reached the "official" stage. Users are 142Gentoo</uri>) are finished and have reached the "official" stage. Users are
141encouraged to use the installation instructions from the Handbook and <uri 143encouraged to use the installation instructions from the Handbook and <uri
142link="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
143their experience (please use the <e>Handbook</e> component). 145their experience (please use the <e>Handbook</e> component).
144</p> 146</p>
145 147
146<p> 148<p>
147More information can be found on the <uri link="handbook/index.xml">Gentoo 149More information can be found on the <uri link="handbook/">Gentoo
148Handbook Effort</uri> homepage. 150Handbook Effort</uri> homepage.
149</p> 151</p>
150 152
151</body> 153</body>
152</section> 154</section>
157<section> 159<section>
158<title>Introduction</title> 160<title>Introduction</title>
159<body> 161<body>
160 162
161<p> 163<p>
162The installation related documentation provides information that can be usefull 164The installation related documentation provides information that can be useful
163during the installation of Gentoo Linux. This includes the part on "Installing 165during the installation of Gentoo Linux. This includes the part on "Installing
164Gentoo" in our Gentoo Handbook, as well as the older but still maintained 166Gentoo" in our Gentoo Handbook, as well as the older but still maintained
165architecture-related installation resources and tutorials that are to be 167architecture-related installation resources and tutorials that are to be
166followed during the installation. 168followed during the installation.
167</p> 169</p>
171<section> 173<section>
172<title>Installation Guides</title> 174<title>Installation Guides</title>
173<body> 175<body>
174 176
175<p> 177<p>
176The part on <b><uri link="/doc/en/handbook/handbook.xml?part=1">Installing
177Gentoo</uri></b> in our <b><uri link="/doc/en/handbook/index.xml">Gentoo 178The first part of our <b><uri link="/doc/en/handbook/index.xml">Gentoo
178Handbook</uri></b> explains how to install Gentoo on your system. It contains 179Handbook</uri></b> explains how to install Gentoo on your system. Each
179instructions for all users, all architectures. 180architecture-specific version contains instructions for all users.
180</p>
181
182<p> 181</p>
183For experienced users we also have a <b><uri 182
183<p>
184For experienced users we also have Quick Installation Reference documents:
185</p>
186
187<ul>
184link="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>
185</p> 189 <li><b><uri link="gentoo-sparc-quickinstall.xml">Sparc Quick Installation Reference</uri></b></li>
190</ul>
186 191
187<p> 192<p>
188Alpha-users are probably also interested in our <b><uri 193Alpha-users are probably also interested in our <b><uri
189link="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
190explains 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.
191</p> 203</p>
192 204
193</body> 205</body>
194</section> 206</section>
195<section> 207<section>
201environment doesn't permit them to boot from a LiveCD. To anticipate their 213environment doesn't permit them to boot from a LiveCD. To anticipate their
202environments we provide the <b><uri link="altinstall.xml">Alternative 214environments we provide the <b><uri link="altinstall.xml">Alternative
203Installation Guide</uri></b> which lists the installation steps needed to install 215Installation Guide</uri></b> which lists the installation steps needed to install
204Gentoo from another medium (distribution, bootable CD, network boot, etc.). 216Gentoo from another medium (distribution, bootable CD, network boot, etc.).
205</p> 217</p>
206<!-- Doc needs updating for LVM2 and 2.6 kernels (also 2.4 <-> 2.6 coop) 218
207<p> 219<p>
208Users 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
209Guide</uri></b> (implemented in the Gentoo Handbook) which explains what steps 221Guide</uri></b> which explains the steps required to get your LVM2 scheme up
210you have to go through to get your LVM scheme up and running. 222and running.
223</p>
224
211</p> 225<p>
212--> 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).
231</p>
232
213<p> 233<p>
214The <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
215Guide</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
216Gentoo Linux 1.4. 236Gentoo Linux 1.4.
217</p> 237</p>
218 238
219<p> 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="migration-to-2.6.xml">complete Gentoo Linux 2.6 migration
247guide</uri></b> tells you everything you need to know to upgrade your system
248from Linux 2.4 to Linux 2.6, devfs to udev and OSS to ALSA.
249</p>
250
251<p>
220The <b><uri link="genkernel.xml">Genkernel Guide</uri></b> intends to provide a 252The <b><uri link="genkernel.xml">Genkernel Guide</uri></b> intends to provide a
221reference of all the functions provided by genkernel. 253reference of all the functions provided by genkernel.
222</p> 254</p>
223 255
256<p>
257With the help of our <b><uri link="colinux-howto.xml">coLinux Howto</uri></b>
258you are able to run Gentoo from within Windows.
259</p>
260
224</body> 261</body>
225</section> 262</section>
226</chapter> 263</chapter>
227 264
228<chapter> 265<chapter>
236Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc. 273Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc.
237</p> 274</p>
238 275
239<p> 276<p>
240The Gentoo Handbook has a part on <uri 277The Gentoo Handbook has a part on <uri
241link="handbook/handbook.xml?part=2">Working with Gentoo</uri> which contains 278link="handbook/handbook-x86.xml?part=2">Working with Gentoo</uri> which contains
242information on Portage, USE flags, the Gentoo Init system and environment 279information on Portage, USE flags, the Gentoo Init system and environment
243variables. 280variables.
244</p> 281</p>
245 282
246</body> 283</body>
248<section> 285<section>
249<title>Portage and Related Documentation</title> 286<title>Portage and Related Documentation</title>
250<body> 287<body>
251 288
252<p> 289<p>
253The <b><uri link="handbook/handbook.xml?part=2&amp;chap=2">Portage and 290<b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">A Portage
254Software</uri></b> chapter in the Gentoo Handbook briefly covers how to keep 291Introduction</uri></b> in the Gentoo Handbook briefly covers how to keep
255your packages up to date and how to maintain your installed software. In other 292your packages up to date and how to maintain your installed software. In other
256words, this chapter tells you how to use <c>emerge</c>. 293words, this chapter tells you how to use <c>emerge</c>.
257</p> 294</p>
258 295
259 296
260<p> 297<p>
261The <b><uri link="portage-manual.xml">Portage Manual</uri></b> provides a general 298The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=3">Portage
262overview of Portage, detailed configuration information and an end user guide 299Features</uri></b> chapter in the Gentoo Handbook provides a general
263to installing and maintaining packages using the Portage system. It is 300overview of Portage' features.
264far more extended than the Portage User Guide.
265</p>
266
267<p> 301</p>
302
303<p>
304The <b><uri link="handbook/handbook-x86.xml?part=3">Working with
305Portage</uri></b> part in the Gentoo Handbook informs you how to
306tweak Portage to suit your environment, your needs. It uncovers the various file
307locations, configuration variables, software branches, etc.
308</p>
309
310<p>
268The <b><uri link="handbook/handbook.xml?part=2&amp;chap=1">USE Flags</uri></b> 311The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri></b>
269chapter in the Gentoo Handbook introduces you to the ultimate 312chapter in the Gentoo Handbook introduces you to the ultimate
270tool for customizing Gentoo -- USE flags. This howto helps you decide which 313tool for customizing Gentoo -- USE flags. This howto helps you decide which
271USE flags you need. It also describes the use of <c>etcat</c> to receive 314USE flags you need. It also describes the use of <c>etcat</c> to receive
272more verbose information regarding USE-flags on a package. 315more verbose information regarding USE-flags on a package.
273</p> 316</p>
274 317
318<p>
319The <b><uri link="gentoolkit.xml">Gentoolkit Guide</uri></b> describes a set of
320very useful portage add-ons.
321</p>
322
323<p>
324The <b><uri link="macos-guide.xml">Gentoo for Mac OS X Guide</uri></b> shows
325how to install portage on a Mac OS X system.
326</p>
327
275</body> 328</body>
276</section> 329</section>
277<section> 330<section>
278<title>Configuring Gentoo</title> 331<title>Configuring Gentoo</title>
279<body> 332<body>
280 333
281<p> 334<p>
282The <b><uri link="handbook/handbook.xml?part=2&amp;chap=6">Environment 335The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Environment
283Variables</uri></b> chapter in the Gentoo Handbook explains how to manage 336Variables</uri></b> chapter in the Gentoo Handbook explains how to manage
284environment variables (such as <path>$PATH</path>) and the dynamic linker 337environment variables (such as <path>$PATH</path>) and the dynamic linker
285cache easily. 338cache easily.
286</p> 339</p>
287 340
288<p> 341<p>
289The <b><uri link="handbook/handbook.xml?part=2&amp;chap=5">Initscripts</uri></b> 342The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=4">Initscripts</uri></b>
290chapter in the Gentoo Handbook details our system 343chapter in the Gentoo Handbook details our system
291startup and service management scripts. Besides the regular 344startup and service management scripts. Besides the regular
292initscript-related items it also covers initscript dependencies and 345initscript-related items it also covers initscript dependencies and
293support for virtuals. 346support for virtuals.
294</p> 347</p>
349Gentoo Linux. IPv6 is the next Internet Protocol and is gaining 402Gentoo Linux. IPv6 is the next Internet Protocol and is gaining
350popularity widely. 403popularity widely.
351</p> 404</p>
352 405
353<p> 406<p>
354The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use User-Mode 407The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use
355Linux under Gentoo Linux. User Mode Linux (UML) provides a nice feature 408User-Mode Linux under Gentoo Linux. User Mode Linux (UML) provides a nice
356for Linux: Running Linux inside Linux (inside Linux inside Linux ...). 409feature for Linux: Running Linux inside Linux (inside Linux inside Linux ...).
357With UML, you can easily create virtual setups. 410With UML, you can easily create virtual setups.
358</p> 411</p>
412
413<!--
414<p>
415The <b><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></b> show you
416how to set up a UML installation with SELinux support.
417</p>
418-->
419
420<p>
421The <b><uri link="kernel-upgrade.xml">Gentoo Linux Kernel Upgrade
422Guide</uri></b> describes the process of upgrading your kernel from one release
423to another.
424</p>
425
359 426
360</body> 427</body>
361</section> 428</section>
362<section> 429<section>
363<title>Specific Administration Guides</title> 430<title>Specific Administration Guides</title>
421The <b><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></b> is a pretty 488The <b><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></b> is a pretty
422useful guide for running a qmail based mail system. It focuses on remote 489useful guide for running a qmail based mail system. It focuses on remote
423access and encrypted communication. 490access and encrypted communication.
424</p> 491</p>
425 492
426</body>
427</section>
428</chapter>
429
430<chapter>
431<title>Desktop Related Documentation</title>
432<section>
433<title>Introduction</title>
434<body>
435
436<p>
437The Desktop Related Documentation contains our Desktop Configuration Guide
438with several other desktop related documents, including several
439application-specific guides.
440</p> 493<p>
441 494The <b><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot
442</body> 495Howto</uri></b> describes how to setup a network booting environment for a Sun
443</section> 496Microsystems SPARC or UltraSPARC based computer.
444<section>
445<title>Desktop Configuration</title>
446<body>
447
448<p> 497</p>
449The <b><uri link="desktop.xml">Desktop Configuration Guide</uri></b> explains how to 498
450set up a fully-functional Gentoo Linux desktop machine. This includes
451configuring KDE/GNOME, Using e-mail, File Sharing (using Samba), etc.
452</p> 499<p>
453 500 The <b><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM reference
501Guide</uri></b> offers a guide to the SPARC OpenBoot system, available on all
502Sun Microsytsms SPARC/UltraSparc based computers.
454<p> 503</p>
455The <b><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></b> is a 504
456comprehensive guide on how to install and use ALSA (Advanced Linux Sound
457Architecture).
458</p> 505<p>
459 506The <b><uri link="quick-samba-howto.xml">Quick SAMBA Howto</uri></b> gives you a
507step-by-step introduction to Samba and includes instructions on setting up an
508anti-virus checking for the Samba shares.
460<p> 509</p>
461The <b><uri link="java.xml">Java Guide</uri></b> explains how Java is handled under 510
462Gentoo Linux.
463</p> 511<p>
464 512The <b><uri link="home-router-howto.xml">Home Router Howto</uri></b> teaches you how to
465<p> 513turn any Gentoo machine into a router for a small network. Perfect for turning an old
466The <b><uri link="guide-localization.xml">Localisation Guide</uri></b> explains how 514computer in your home into a useful firewall/router/etc...
467to localise Gentoo Linux for non-English users.
468</p>
469
470<p>
471The <b><uri link="dri-howto.xml">Direct Rendering Howto</uri></b> explains how to get
4723D acceleration working using XFree-DRM.
473</p>
474
475<p>
476The <b><uri link="ati-faq.xml">ATI FAQ</uri></b> provides the answers to frequently
477asked questions regarding ATI graphical cards.
478</p>
479
480</body>
481</section>
482<section>
483<title>Application Specific Documentation</title>
484<body>
485
486<p>
487The <b><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></b> leads by example
488to explain the basics of Nano.
489</p>
490
491<p>
492The <b><uri link="vi-guide.xml">Vi Guide</uri></b> uses the cheatsheet method to
493teach the basics of vi.
494</p>
495
496<p>
497The <b><uri link="gnupg-user.xml">GnuPG User Guide</uri></b> is the definitive guide
498on GnuPG.
499</p>
500
501<p>
502The <b><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></b>
503explains how to use fetchmail, procmail, mutt, and nbsmtp.
504</p>
505
506<p>
507The <b><uri link="cvs-tutorial.xml">CVS Tutorial</uri></b> documents the basics of
508using CVS, the Concurrent Versioning System.
509</p> 515</p>
510 516
511</body> 517</body>
512</section> 518</section>
513</chapter> 519</chapter>
517<section> 523<section>
518<title>Introduction</title> 524<title>Introduction</title>
519<body> 525<body>
520 526
521<p> 527<p>
522Gentoo is a volunteer-driven distribution. It is therefor vital to have 528Gentoo is a volunteer-driven distribution. It is therefore vital to have
523high-quality development-related documentation available so that interested 529high-quality development-related documentation available so that interested
524users can easily learn how to help in the development of their favorite 530users can easily learn how to help in the development of their favorite
525distribution. 531distribution.
526</p> 532</p>
527 533
528</body> 534</body>
529</section> 535</section>
530<section> 536<section>
537<title>Gentoo Developer Handbook</title>
538<body>
539
540<p>
541All developer-specific documentation, including but not limited to Ebuild and
542Eclass development, policies and such, has now been bundled in one awsome <b>
543<uri link="/proj/en/devrel/handbook/handbook.xml">Gentoo Developer
544Handbook</uri></b> for your reading pleasure.
545</p>
546
547</body>
548</section>
549<section>
531<title>Gentoo Development Policies</title> 550<title>Gentoo Development Policies</title>
532<body> 551<body>
533 552
534<p> 553<p>
535The <b><uri link="policy.xml">Gentoo Linux Development Policy</uri></b> details
536current policy for the creation of ebuilds.
537</p>
538
539<!--
540<p>
541The <b><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></b>
542details current policy for Gentoo Linux releases.
543</p>
544-->
545
546<p>
547The <b><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></b> 554The <b><uri link="/proj/en/gdp/doc/doc-policy.xml">Gentoo Linux Documentation Policy</uri></b>
548details current policy for the creation and editing of documentation. 555details current policy for the creation and editing of documentation.
549</p> 556</p>
550 557
551</body> 558</body>
552</section> 559</section>
553<section> 560<section>
554<title>Development Related Documentation</title> 561<title>Development Related Documentation</title>
555<body> 562<body>
556
557<p>
558The <b><uri link="gentoo-howto.xml">Ebuild HOWTO</uri></b> explains how to
559create ebuilds.
560</p>
561
562<p>
563The <b><uri link="eclass-howto.xml">Eclass HOWTO</uri></b> shows how to create
564ebuilds that support OOP-like inheritance features.
565</p>
566 563
567<p> 564<p>
568The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b> 565The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b>
569explains how to submit user-authored ebuilds. 566explains how to submit user-authored ebuilds.
570</p> 567</p>
571 568
572<p> 569<p>
573The <b><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></b>
574lists the common mistakes contributors/developers make when trying to submit an
575ebuild.
576</p>
577
578<p>
579The <b><uri link="metadata.xml">Metadata document</uri></b> explains how to
580write up a <path>metadata.xml</path> file for a package.
581</p>
582
583<p>
584The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML 570The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML
585format used in Gentoo Linux's web-based documentation. 571format used in Gentoo Linux's web-based documentation.
572</p>
573
574<p>
575The <b><uri link="/proj/en/gdp/doc/doc-tipsntricks.xml">Doc Developers' Tips
576&amp; Tricks</uri></b> contains some pointers for documentation developers.
577</p>
578
579<p>
580The <b><uri link="cvs-tutorial.xml">CVS Tutorial</uri></b> documents the basics
581of using CVS, the Concurrent Versioning System.
586</p> 582</p>
587 583
588</body> 584</body>
589</section> 585</section>
590</chapter> 586</chapter>
620 616
621<table> 617<table>
622<tr><th>Frequently Asked Questions</th></tr> 618<tr><th>Frequently Asked Questions</th></tr>
623<tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr> 619<tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr>
624<tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr> 620<tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr>
621<tr><ti><uri link="gentoo-sparc-faq.xml">Gentoo SPARC FAQ</uri></ti></tr>
625<tr><th>Installation Related Documentation</th></tr> 622<tr><th>Installation Related Documentation</th></tr>
626<tr><ti><uri link="handbook/handbook.xml?part=1">Installing Gentoo</uri></ti></tr> 623<tr><ti><uri link="handbook/">Gentoo Handbook</uri></ti></tr>
627<tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Rerefence</uri></ti></tr> 624<tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Reference</uri></ti></tr>
625<tr><ti><uri link="gentoo-sparc-quickinstall.xml">Gentoo sparc Quick Installation Reference</uri></ti></tr>
628<tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr> 626<tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr>
627<tr><ti><uri link="/proj/en/base/amd64/technotes.xml">AMD64 Technotes</uri></ti></tr>
629<tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr> 628<tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr>
630<!--<tr><ti><uri link="lvm.xml">LVM Guide</uri></ti></tr>--> 629<tr><ti><uri link="lvm2.xml">LVM2 Guide</uri></ti></tr>
630<tr><ti><uri link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Tips 'n Tricks Document</uri></ti></tr>
631<tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr> 631<tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr>
632<tr><ti><uri link="gentoo-upgrading.xml">Gentoo Upgrading Howto</uri></ti></tr>
633<tr><ti><uri link="migration-to-2.6.xml">Gentoo Linux 2.6 Migration Guide</uri></ti></tr>
632<tr><ti><uri link="genkernel.xml">Genkernel Guide</uri></ti></tr> 634<tr><ti><uri link="genkernel.xml">Genkernel Guide</uri></ti></tr>
635<tr><ti><uri link="colinux-howto.xml">coLinux Howto</uri></ti></tr>
633<tr><th>Gentoo System Documentation</th></tr> 636<tr><th>Gentoo System Documentation</th></tr>
637<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">A Portage Introduction</uri></ti></tr>
634<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=2">Portage and Software</uri></ti></tr> 638<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=3">Portage Features</uri></ti></tr>
635<tr><ti><uri link="portage-manual.xml">Portage Manual Guide</uri></ti></tr> 639<tr><ti><uri link="handbook/handbook-x86.xml?part=3">Working with Portage</uri></ti></tr>
636<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=1">USE Flags</uri></ti></tr> 640<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">USE Flags</uri></ti></tr>
637<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=6">Environment Variables</uri></ti></tr> 641<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Environment Variables</uri></ti></tr>
638<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=5">Initscripts</uri></ti></tr> 642<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=4">Initscripts</uri></ti></tr>
639<tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr> 643<tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr>
644<tr><ti><uri link="gentoolkit.xml">Gentoolkit Guide</uri></ti></tr>
645<tr><ti><uri link="macos-guide.xml">Gentoo for Mac OS X</uri></ti></tr>
640<tr><th>System Administration Documentation</th></tr> 646<tr><th>System Administration Documentation</th></tr>
641<tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr> 647<tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr>
642<tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr> 648<tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr>
643<tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr> 649<tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr>
644<tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr> 650<tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr>
651<!-- <tr><ti><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></ti></tr>
652-->
645<tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> 653<!-- <tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> -->
646<tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr> 654<tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr>
647<tr><ti><uri link="diskless-howto.xml">Diskless Guide</uri></ti></tr> 655<tr><ti><uri link="diskless-howto.xml">Diskless Guide</uri></ti></tr>
648<tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr> 656<tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr>
649<tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr> 657<tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr>
650<tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr> 658<tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr>
651<tr><ti><uri link="udev-guide.xml">Gentoo udev Guide</uri></ti></tr> 659<tr><ti><uri link="udev-guide.xml">Gentoo udev Guide</uri></ti></tr>
652<tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr> 660<tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr>
653<tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr> 661<tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr>
654<tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></ti></tr> 662<tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></ti></tr>
655<tr><ti><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></ti></tr> 663<tr><ti><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></ti></tr>
656<tr><th>Desktop Related Documentation</th></tr> 664<tr><ti><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot Howto</uri></ti></tr>
665<tr><ti><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM Reference Guide</uri></ti></tr>
666<tr><ti><uri link="quick-samba-howto.xml">Quick Samba Howto</uri></ti></tr>
667<tr><ti><uri link="home-router-howto.xml">Home Router Howto</uri></ti></tr>
657<tr><ti><uri link="desktop.xml">Desktop Configuration Guide</uri></ti></tr> 668<tr><th><uri link="desktop.xml">Gentoo Desktop Documentation</uri></th></tr>
658<tr><ti><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></ti></tr> 669<tr><th>Gentoo Development Documentation</th></tr>
659<tr><ti><uri link="java.xml">Java Guide</uri></ti></tr> 670<tr><ti><uri link="/proj/en/devrel/handbook/handbook.xml">Gentoo Developer Handbook</uri></ti></tr>
660<tr><ti><uri link="guide-localization.xml">Localisation Guide</uri></ti></tr> 671<tr><ti><uri link="/proj/en/devrel/handbook/handbook.xml?part=3&amp;chap=1">Gentoo Ebuild Policy</uri></ti></tr>
661<tr><ti><uri link="dri-howto.xml">Direct Rendering Howto</uri></ti></tr> 672<tr><ti><uri link="/proj/en/gdp/doc/doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr>
662<tr><ti><uri link="ati-faq.xml">ATI FAQ</uri></ti></tr> 673<tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr>
663<tr><ti><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></ti></tr>
664<tr><ti><uri link="vi-guide.xml">Vi Guide</uri></ti></tr> 674<tr><ti><uri link="xml-guide.xml">GuideXML Guide</uri></ti></tr>
665<tr><ti><uri link="gnupg-user.xml">GnuPG User Guide</uri></ti></tr> 675<tr><ti><uri link="/proj/en/gdp/doc/doc-tipsntricks.xml">Doc Developers' Tips &amp; Tricks</uri></ti></tr>
666<tr><ti><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></ti></tr>
667<tr><ti><uri link="cvs-tutorial.xml">CVS Tutorial</uri></ti></tr> 676<tr><ti><uri link="cvs-tutorial.xml">CVS Tutorial</uri></ti></tr>
668<tr><th>Gentoo Development Documentation</th></tr>
669<tr><ti><uri link="policy.xml">Gentoo Linux Development Policy</uri></ti></tr>
670<!-- <tr><ti><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></ti></tr> -->
671<tr><ti><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr>
672<tr><ti><uri link="gentoo-howto.xml">Ebuild Howto</uri></ti></tr>
673<tr><ti><uri link="eclass-howto.xml">Eclass Howto</uri></ti></tr>
674<tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr>
675<tr><ti><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></ti></tr>
676<tr><ti><uri link="metadata.xml">Metadata document</uri></ti></tr>
677<tr><th>Other Documentation</th></tr> 677<tr><th>Other Documentation</th></tr>
678<tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr> 678<tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr>
679<tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr> 679<tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr>
680</table> 680</table>
681 681

Legend:
Removed from v.1.43  
changed lines
  Added in v.1.86

  ViewVC Help
Powered by ViewVC 1.1.20