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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.63 - (hide annotations) (download) (as text)
Wed May 12 08:27:54 2004 UTC (10 years, 2 months ago) by swift
Branch: MAIN
Changes since 1.62: +8 -2 lines
File MIME type: application/xml
Add GNOME Configuration HOWTO

1 swift 1.1 <?xml version="1.0" encoding="UTF-8"?>
2 swift 1.63 <!-- $Header: /home/cvsroot/gentoo/xml/htdocs/doc/en/index.xml,v 1.62 2004/05/12 08:23:49 swift Exp $ -->
3 swift 1.32 <!DOCTYPE mainpage SYSTEM "/dtd/guide.dtd">
4 swift 1.1 <mainpage id="docs">
5     <title>Gentoo Documentation Resources</title>
6     <author title="Author">
7     <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
8     </author>
9 swift 1.6 <author title="Editor"><!-- zhen@gentoo.org -->
10     John P. Davis
11 swift 1.1 </author>
12     <author title="Editor">Colin Morey</author>
13     <author title="Editor">
14     <mail link="peesh@gentoo.org">Jorge Paulo</mail>
15     </author>
16     <author title="Editor">
17     <mail link="swift@gentoo.org">Sven Vermeulen</mail>
18     </author>
19 swift 1.63 <version>2.29</version>
20 swift 1.62 <date>May 12, 2004</date>
21 swift 1.1
22     <chapter>
23     <title>Gentoo Documentation Resources</title>
24     <section>
25 swift 1.2 <title>Available Languages</title>
26     <body>
27    
28     <p>
29     This page (and documentation) is available in the following languages:
30     </p>
31    
32     <p>
33 swift 1.9 <uri link="http://www.gentoo.org/doc/da/index.xml">Danish</uri> |
34 swift 1.2 <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 erwin 1.46 <uri link="http://www.gentoo.org/doc/id/index.xml">Indonesian</uri> |
40 swift 1.2 <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 swift 1.10 <!-- <uri link="http://www.gentoo.org/doc/kr/index.xml">Korean</uri> | -->
43 swift 1.2 <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 dertobi123 1.36 <uri link="http://www.gentoo.org/doc/tw/index.xml">Traditional Chinese</uri>
46 swift 1.2 </p>
47    
48     </body>
49     </section>
50     <section>
51 swift 1.1 <title>Contents</title>
52     <body>
53    
54     <ul>
55     <li><uri link="#doc_chap1">Introduction</uri></li>
56     <li><uri link="#doc_chap2">Installation Related Resources</uri></li>
57     <li><uri link="#doc_chap3">Gentoo System 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>
60     <li><uri link="#doc_chap6">Gentoo Development Documentation</uri></li>
61     <li><uri link="#doc_chap7">Other Documentation</uri></li>
62 swift 1.5 <li><uri link="#doc_chap8">Overview of Available Documentation</uri></li>
63 swift 1.1 </ul>
64    
65     </body>
66     </section>
67     <section>
68     <title>Introduction</title>
69     <body>
70    
71     <p>
72     Welcome to the Gentoo Documentation Resources. This page will give you a
73     quick overview on the documentation we provide. Most documentation is
74     released under the <uri
75     link="http://creativecommons.org/licenses/by-sa/1.0">Creative Commons -
76     Attribution / Share Alike</uri> license, an open documentation license. All
77     documentation should also be available in a printer-friendly format. To view
78     this document, append <path>?style=printable</path> to the URL.
79     </p>
80    
81     <p>
82     If you find bugs in our documentation or have proposals, please use our
83     <uri link="http://bugs.gentoo.org">Bugtracking System</uri> and fill in
84 swift 1.17 a bug report for "Docs-developer" or "Docs-user". These bug reports will
85 swift 1.1 then be handled by the <uri
86     link="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation
87     Project</uri>.
88     </p>
89    
90     </body>
91     </section>
92     <section>
93     <title>Internationalisation Effort</title>
94     <body>
95    
96     <p>
97     Our documentation is available in several languages. Although not all
98     documents are translated, we do our best to keep them all up to date and
99     provide our users with as much translated documentation as possible. If
100     you want to help with our translation efforts, please contact <mail
101 neysx 1.40 link="neysx@gentoo.org">Xavier Neys</mail> who is in charge of
102 swift 1.1 the internationalisation efforts.
103     </p>
104    
105     </body>
106     </section>
107     <section>
108     <title>Frequently Asked Questions</title>
109     <body>
110    
111     <p>
112     As with every major project Gentoo has a FAQ too. We have first and foremost
113 swift 1.54 a couple of official FAQs maintained by the Gentoo Documentation Project:
114 swift 1.1 </p>
115    
116     <ul>
117     <li>The <b><uri link="faq.xml">Gentoo FAQ</uri></b> answers Frequently Asked Questions
118     about 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
120     Asked Questions about Gentoo Linux on the PowerPC platform.</li>
121 swift 1.52 <li>The <b><uri link="gentoo-sparc-faq.xml">Gentoo SPARC FAQ</uri></b> answers
122     Frequently Asked Questions about Gentoo Linux on the SPARC platform.</li>
123 swift 1.1 </ul>
124    
125     <p>
126     Furthermore we have a very extensive collection of FAQs on our <uri
127     link="http://forums.gentoo.org">forums</uri>. To view those, go to
128     <uri>http://forums.gentoo.org/viewforum.php?f=40</uri>.
129 swift 1.8 </p>
130    
131     </body>
132     </section>
133     <section>
134     <title>Gentoo Handbook</title>
135     <body>
136    
137     <p>
138     The Gentoo Documentation Project has started with the <uri
139 neysx 1.49 link="handbook/">Gentoo Handbook</uri> development. Currently, the
140     first two parts (<uri link="handbook/handbook-x86.xml?part=1">Installing
141     Gentoo</uri> and <uri link="handbook/handbook-x86.xml?part=2">Working with
142 swift 1.18 Gentoo</uri>) are finished and have reached the "official" stage. Users are
143     encouraged to use the installation instructions from the Handbook and <uri
144 swift 1.8 link="http://bugs.gentoo.org/enter_bug.cgi?product=Docs-user">bug</uri> us with
145     their experience (please use the <e>Handbook</e> component).
146     </p>
147    
148     <p>
149 neysx 1.49 More information can be found on the <uri link="handbook/">Gentoo
150 swift 1.8 Handbook Effort</uri> homepage.
151 swift 1.1 </p>
152    
153     </body>
154     </section>
155     </chapter>
156    
157     <chapter>
158     <title>Installation Related Resources</title>
159     <section>
160     <title>Introduction</title>
161     <body>
162    
163     <p>
164 swift 1.11 The installation related documentation provides information that can be usefull
165     during the installation of Gentoo Linux. This includes the part on "Installing
166     Gentoo" in our Gentoo Handbook, as well as the older but still maintained
167     architecture-related installation resources and tutorials that are to be
168 swift 1.31 followed during the installation.
169 swift 1.1 </p>
170    
171     </body>
172     </section>
173     <section>
174     <title>Installation Guides</title>
175     <body>
176    
177     <p>
178 neysx 1.49 The first part of our <b><uri link="/doc/en/handbook/index.xml">Gentoo
179     Handbook</uri></b> explains how to install Gentoo on your system. Each
180     architecture-specific version contains instructions for all users.
181 swift 1.1 </p>
182    
183     <p>
184 swift 1.47 For experienced users we also have Quick Installation Reference documents:
185 swift 1.1 </p>
186 swift 1.42
187 swift 1.47 <ul>
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>
191    
192 swift 1.1 <p>
193     Alpha-users are probably also interested in our <b><uri
194     link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></b>, which
195     explains how to set up the Compaq Tools package for Gentoo Alpha users.
196     </p>
197    
198     </body>
199     </section>
200     <section>
201     <title>Other Installation Related Documentation</title>
202     <body>
203    
204     <p>
205     For some people, the installation guide above doesn't suffice since their
206     environment doesn't permit them to boot from a LiveCD. To anticipate their
207     environments we provide the <b><uri link="altinstall.xml">Alternative
208     Installation Guide</uri></b> which lists the installation steps needed to install
209     Gentoo from another medium (distribution, bootable CD, network boot, etc.).
210     </p>
211 neysx 1.48
212 swift 1.1 <p>
213 neysx 1.48 Users interested in using LVM2 should read up our <b><uri link="lvm2.xml">LVM2
214     Guide</uri></b> which explains the steps required to get your LVM2 scheme up
215     and running.
216 swift 1.1 </p>
217 neysx 1.48
218 swift 1.1 <p>
219 swift 1.51 As our installation instructions allow for great flexibility, there are many
220     tips and tricks that can be persued during the installation. We have a <b><uri
221     link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Installation Tips 'n
222     Tricks</uri></b> document online (which also contains interesting Tips 'n Tricks
223     for other architectures).
224     </p>
225    
226     <p>
227 swift 1.1 The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade
228     Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to
229     Gentoo Linux 1.4.
230     </p>
231    
232 swift 1.29 <p>
233     The <b><uri link="genkernel.xml">Genkernel Guide</uri></b> intends to provide a
234     reference of all the functions provided by genkernel.
235     </p>
236    
237 swift 1.55 <p>
238     With the help of our <b><uri link="colinux-howto.xml">coLinux HOWTO</uri></b>
239     you are able to run Gentoo from within Windows.
240     </p>
241    
242 swift 1.1 </body>
243     </section>
244     </chapter>
245    
246     <chapter>
247     <title>Gentoo System Documentation</title>
248     <section>
249     <title>Introduction</title>
250     <body>
251    
252     <p>
253     The Gentoo System Documentation contains several guides about what makes
254     Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc.
255     </p>
256    
257 swift 1.18 <p>
258     The Gentoo Handbook has a part on <uri
259 neysx 1.49 link="handbook/handbook-x86.xml?part=2">Working with Gentoo</uri> which contains
260 swift 1.18 information on Portage, USE flags, the Gentoo Init system and environment
261     variables.
262     </p>
263    
264 swift 1.1 </body>
265     </section>
266     <section>
267     <title>Portage and Related Documentation</title>
268     <body>
269    
270     <p>
271 neysx 1.49 The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and
272 swift 1.33 Software</uri></b> chapter in the Gentoo Handbook briefly covers how to keep
273     your packages up to date and how to maintain your installed software. In other
274     words, this chapter tells you how to use <c>emerge</c>.
275 swift 1.1 </p>
276    
277 swift 1.33
278 swift 1.1 <p>
279     The <b><uri link="portage-manual.xml">Portage Manual</uri></b> provides a general
280     overview of Portage, detailed configuration information and an end user guide
281     to installing and maintaining packages using the Portage system. It is
282     far more extended than the Portage User Guide.
283     </p>
284    
285     <p>
286 neysx 1.49 The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></b>
287 swift 1.33 chapter in the Gentoo Handbook introduces you to the ultimate
288 swift 1.1 tool for customizing Gentoo -- USE flags. This howto helps you decide which
289     USE flags you need. It also describes the use of <c>etcat</c> to receive
290 swift 1.7 more verbose information regarding USE-flags on a package.
291 swift 1.1 </p>
292    
293     </body>
294     </section>
295     <section>
296     <title>Configuring Gentoo</title>
297     <body>
298    
299     <p>
300 neysx 1.49 The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment
301 swift 1.33 Variables</uri></b> chapter in the Gentoo Handbook explains how to manage
302 swift 1.1 environment variables (such as <path>$PATH</path>) and the dynamic linker
303     cache easily.
304     </p>
305    
306     <p>
307 neysx 1.49 The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></b>
308 swift 1.33 chapter in the Gentoo Handbook details our system
309 swift 1.1 startup and service management scripts. Besides the regular
310     initscript-related items it also covers initscript dependencies and
311     support for virtuals.
312     </p>
313    
314     </body>
315     </section>
316     <section>
317     <title>Gentoo Choices</title>
318     <body>
319    
320     <p>
321     The <b><uri link="gentoo-kernel.xml">Kernel Guide</uri></b> lists the various
322     kernel sources Gentoo provides. Most of these kernels are maintained by
323     the <uri link="http://www.gentoo.org/proj/en/kernel">Gentoo Kernel
324     Project</uri>.
325     </p>
326    
327     </body>
328     </section>
329     </chapter>
330    
331     <chapter>
332     <title>System Administration Documentation</title>
333     <section>
334     <title>Introduction</title>
335     <body>
336    
337     <p>
338     The System Administration Documentation contains tutorials and guides on how to
339     install, configure and/or manage certain aspects of system administration.
340     Although the focus is on Gentoo systems, several of these guides can very well
341     be used by non-Gentoo users.
342     </p>
343    
344     </body>
345     </section>
346     <section>
347     <title>General System Administration</title>
348     <body>
349    
350     <p>
351     The <b><uri link="gentoo-security.xml">Gentoo Security Guide</uri></b> explains how
352     to harden a Gentoo Linux system against intruders and attacks. It
353     contains general security information (securing services, designing firewalls,
354     using IDS, kernel security etc.). For even tighter hardening please
355     visit the <uri link="http://www.gentoo.org/proj/en/hardened">Gentoo
356     Hardened</uri> website.
357     </p>
358    
359     <p>
360     The <b><uri link="prelink-howto.xml">Prelinking Guide</uri></b> explains how to
361     enhance your system using prelink. With prelinking, bigger applications
362     start up faster.
363     </p>
364    
365     <p>
366     The <b><uri link="ipv6.xml">IPv6 Guide</uri></b> shows how to setup IPv6 under
367     Gentoo Linux. IPv6 is the next Internet Protocol and is gaining
368     popularity widely.
369     </p>
370    
371     <p>
372 swift 1.44 The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use
373     User-Mode Linux under Gentoo Linux. User Mode Linux (UML) provides a nice
374     feature for Linux: Running Linux inside Linux (inside Linux inside Linux ...).
375 swift 1.1 With UML, you can easily create virtual setups.
376     </p>
377    
378 swift 1.56 <!--
379 swift 1.44 <p>
380     The <b><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></b> show you
381     how to set up a UML installation with SELinux support.
382     </p>
383 swift 1.56 -->
384 swift 1.44
385 swift 1.1 </body>
386     </section>
387     <section>
388     <title>Specific Administration Guides</title>
389     <body>
390    
391 swift 1.23 <!-- Some possible security issues, see #39718
392 swift 1.1 <p>
393     The <b><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></b> explains how
394     to administer user accounts centralised using OpenLDAP.
395     </p>
396 swift 1.23 -->
397 swift 1.1
398     <p>
399     The <b><uri link="openmosix-howto.xml">OpenMosix Howto</uri></b> describes step by
400 neysx 1.12 step how you can create a farm of openmosix nodes (a cluster of several PCs).
401     </p>
402    
403     <p>
404     The <b><uri link="diskless-howto.xml">Diskless Howto</uri></b> describes step by
405     step how you can set up diskless nodes with Gentoo.
406 swift 1.1 </p>
407    
408     <p>
409     The <b><uri link="ltsp.xml">LTSP Guide</uri></b> explains how to setup a Linux
410     Terminal Server with Gentoo.
411     </p>
412    
413     <p>
414     The <b><uri link="distcc.xml">Distcc Guide</uri></b> informs you how to use distcc
415     for distributed compilations with Gentoo Linux.
416     </p>
417    
418     <p>
419     The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works
420     and how to administer it.
421     </p>
422    
423     <p>
424 swift 1.41 The <b><uri link="udev-guide.xml">Gentoo udev Guide</uri></b> describes the new
425     device file management (using udev) which replaces DevFS and informs the reader
426     how udev is integrated in Gentoo.
427     </p>
428    
429     <p>
430 swift 1.1 The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive
431     guide to Gentoo and printing.
432     </p>
433    
434     <p>
435     The <b><uri link="openafs.xml">OpenAFS Guide</uri></b> documents the use and
436     installation of OpenAFS, a distributed network-based file sharing technology.
437     </p>
438    
439     <p>
440 vapier 1.27 The <b><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></b> is
441     the essential guide for any postfix mail administrator. It covers the use of MySQL
442     for virtual users, webbased e-mail software, mailinglist software etc.
443     </p>
444    
445     <p>
446     The <b><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></b> is a pretty
447 vapier 1.28 useful guide for running a qmail based mail system. It focuses on remote
448     access and encrypted communication.
449 swift 1.1 </p>
450    
451 swift 1.52 <p>
452     The <b><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot
453     HOWTO</uri></b> describes how to setup a network booting environment for a Sun
454     Microsystems SPARC or UltraSPARC based computer.
455     </p>
456    
457 swift 1.57 <p>
458 peitolm 1.60 The <b><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM reference
459 peitolm 1.58 Guide</uri></b> offers a guide to the SPARC OpenBoot system, available on all
460     Sun Microsytsms SPARC/UltraSparc based computers.
461     </p>
462    
463     <p>
464 swift 1.57 The <b><uri link="quick-samba-howto.xml">Quick SAMBA Howto</uri></b> gives you a
465     step-by-step introduction to Samba and includes instructions on setting up an
466     anti-virus checking for the Samba shares.
467     </p>
468    
469 swift 1.1 </body>
470     </section>
471     </chapter>
472    
473     <chapter>
474     <title>Desktop Related Documentation</title>
475     <section>
476     <title>Introduction</title>
477     <body>
478    
479     <p>
480     The Desktop Related Documentation contains our Desktop Configuration Guide
481     with several other desktop related documents, including several
482     application-specific guides.
483     </p>
484    
485     </body>
486     </section>
487     <section>
488     <title>Desktop Configuration</title>
489     <body>
490    
491     <p>
492     The <b><uri link="desktop.xml">Desktop Configuration Guide</uri></b> explains how to
493     set up a fully-functional Gentoo Linux desktop machine. This includes
494     configuring KDE/GNOME, Using e-mail, File Sharing (using Samba), etc.
495     </p>
496    
497     <p>
498     The <b><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></b> is a
499     comprehensive guide on how to install and use ALSA (Advanced Linux Sound
500     Architecture).
501     </p>
502    
503     <p>
504     The <b><uri link="java.xml">Java Guide</uri></b> explains how Java is handled under
505     Gentoo Linux.
506     </p>
507    
508     <p>
509     The <b><uri link="guide-localization.xml">Localisation Guide</uri></b> explains how
510     to localise Gentoo Linux for non-English users.
511     </p>
512    
513     <p>
514     The <b><uri link="dri-howto.xml">Direct Rendering Howto</uri></b> explains how to get
515     3D acceleration working using XFree-DRM.
516     </p>
517    
518     <p>
519     The <b><uri link="ati-faq.xml">ATI FAQ</uri></b> provides the answers to frequently
520     asked questions regarding ATI graphical cards.
521     </p>
522    
523 swift 1.61 <p>
524     The <b><uri link="xorg-config.xml">XOrg Configuration HOWTO</uri></b> talks
525     about the installation and configuration of X.org.
526     </p>
527    
528 swift 1.62 <p>
529     The <b><uri link="kde-config.xml">KDE Configuration HOWTO</uri></b> talks about
530     the installation and configuration of KDE.
531     </p>
532    
533 swift 1.63 <p>
534     The <b><uri link="gnome-config.xml">GNOME Configuration HOWTO</uri></b> talks
535     about the installation and configuration of GNOME.
536     </p>
537    
538 swift 1.1 </body>
539     </section>
540     <section>
541     <title>Application Specific Documentation</title>
542     <body>
543    
544     <p>
545     The <b><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></b> leads by example
546     to explain the basics of Nano.
547     </p>
548    
549     <p>
550     The <b><uri link="vi-guide.xml">Vi Guide</uri></b> uses the cheatsheet method to
551     teach the basics of vi.
552     </p>
553    
554     <p>
555     The <b><uri link="gnupg-user.xml">GnuPG User Guide</uri></b> is the definitive guide
556     on GnuPG.
557     </p>
558    
559     <p>
560     The <b><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></b>
561     explains how to use fetchmail, procmail, mutt, and nbsmtp.
562     </p>
563    
564     <p>
565     The <b><uri link="cvs-tutorial.xml">CVS Tutorial</uri></b> documents the basics of
566     using CVS, the Concurrent Versioning System.
567     </p>
568    
569     </body>
570     </section>
571     </chapter>
572    
573     <chapter>
574     <title>Gentoo Development Documentation</title>
575     <section>
576     <title>Introduction</title>
577     <body>
578    
579     <p>
580 swift 1.53 Gentoo is a volunteer-driven distribution. It is therefore vital to have
581 swift 1.1 high-quality development-related documentation available so that interested
582     users can easily learn how to help in the development of their favorite
583     distribution.
584     </p>
585    
586     </body>
587     </section>
588     <section>
589     <title>Gentoo Development Policies</title>
590     <body>
591    
592     <p>
593     The <b><uri link="policy.xml">Gentoo Linux Development Policy</uri></b> details
594     current policy for the creation of ebuilds.
595     </p>
596    
597 swift 1.15 <!--
598 swift 1.1 <p>
599     The <b><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></b>
600     details current policy for Gentoo Linux releases.
601     </p>
602 swift 1.15 -->
603 swift 1.1
604     <p>
605 swift 1.24 The <b><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></b>
606     details current policy for the creation and editing of documentation.
607 swift 1.1 </p>
608    
609     </body>
610     </section>
611     <section>
612     <title>Development Related Documentation</title>
613     <body>
614    
615     <p>
616 swift 1.24 The <b><uri link="gentoo-howto.xml">Ebuild HOWTO</uri></b> explains how to
617     create ebuilds.
618 swift 1.1 </p>
619    
620     <p>
621     The <b><uri link="eclass-howto.xml">Eclass HOWTO</uri></b> shows how to create
622     ebuilds that support OOP-like inheritance features.
623     </p>
624    
625     <p>
626 swift 1.24 The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b>
627     explains how to submit user-authored ebuilds.
628 swift 1.1 </p>
629    
630 swift 1.25 <p>
631     The <b><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></b>
632     lists the common mistakes contributors/developers make when trying to submit an
633     ebuild.
634     </p>
635    
636 swift 1.1 <p>
637 swift 1.24 The <b><uri link="metadata.xml">Metadata document</uri></b> explains how to
638     write up a <path>metadata.xml</path> file for a package.
639     </p>
640    
641     <p>
642     The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML
643     format used in Gentoo Linux's web-based documentation.
644 swift 1.1 </p>
645    
646 neysx 1.45 <p>
647     The <b><uri link="doc-tipsntricks.xml">Doc Developers' Tips &amp;
648     Tricks</uri></b> contains some pointers for documentation developers.
649     </p>
650    
651 swift 1.1 </body>
652     </section>
653     </chapter>
654    
655     <chapter>
656     <title>Other Documentation</title>
657     <section>
658     <body>
659    
660     <ul>
661     <li>View our <uri link="http://www.gentoo.org/cgi-bin/viewcvs.cgi">CVS repository</uri> if you need to look at our code and ebuilds.</li>
662     <li><b><uri link="http://www.gentoo.org/main/en/about.xml">About</uri></b> the Gentoo Project.</li>
663     <li>Gentoo's <b><uri link="http://www.gentoo.org/main/en/contract.xml">Social Contract</uri></b>.</li>
664     <li>More on the <b><uri link="http://www.gentoo.org/proj/en/site.xml">XML projects</uri></b> Gentoo has gone through.</li>
665     <li>How to <b><uri link="rsync.xml">Mirror Gentoo : Rsync</uri></b>.</li>
666     <li>How to <b><uri link="source_mirrors.xml">Mirror Gentoo : Distfiles</uri></b>.</li>
667     <li>Gentoo Linux News (<uri link="http://www.gentoo.org/rdf/en/gentoo-news.rdf">RDF</uri>, <uri
668     link="http://purl.org/net/syndication/subscribe/?rss=http://www.gentoo.org/rdf/en/gentoo-news.rdf">Subscribe</uri>).</li>
669     </ul>
670    
671     </body>
672     </section>
673     </chapter>
674 swift 1.4 <chapter>
675     <title>Document Listing</title>
676 swift 1.32 <section>
677 swift 1.4 <body>
678    
679     <p>
680     For people who like to get a short overview on available documentation, here it
681     is :)
682     </p>
683    
684     <table>
685     <tr><th>Frequently Asked Questions</th></tr>
686     <tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr>
687     <tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr>
688 swift 1.52 <tr><ti><uri link="gentoo-sparc-faq.xml">Gentoo SPARC FAQ</uri></ti></tr>
689 swift 1.4 <tr><th>Installation Related Documentation</th></tr>
690 neysx 1.49 <tr><ti><uri link="handbook/">Gentoo Handbook</uri></ti></tr>
691 swift 1.42 <tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Rerefence</uri></ti></tr>
692 swift 1.47 <tr><ti><uri link="gentoo-sparc-quickinstall.xml">Gentoo sparc Quick Installation Rerefence</uri></ti></tr>
693 swift 1.4 <tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr>
694     <tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr>
695 neysx 1.48 <tr><ti><uri link="lvm2.xml">LVM2 Guide</uri></ti></tr>
696 swift 1.51 <tr><ti><uri link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Tips 'n Tricks Document</uri></ti></tr>
697 swift 1.4 <tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr>
698 swift 1.29 <tr><ti><uri link="genkernel.xml">Genkernel Guide</uri></ti></tr>
699 swift 1.55 <tr><ti><uri link="colinux-howto.xml">coLinux HOWTO</uri></ti></tr>
700 swift 1.4 <tr><th>Gentoo System Documentation</th></tr>
701 neysx 1.49 <tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and Software</uri></ti></tr>
702 swift 1.4 <tr><ti><uri link="portage-manual.xml">Portage Manual Guide</uri></ti></tr>
703 neysx 1.49 <tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></ti></tr>
704     <tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment Variables</uri></ti></tr>
705     <tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></ti></tr>
706 swift 1.4 <tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr>
707     <tr><th>System Administration Documentation</th></tr>
708     <tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr>
709     <tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr>
710     <tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr>
711     <tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr>
712 swift 1.56 <!-- <tr><ti><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></ti></tr>
713     -->
714 swift 1.50 <!-- <tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> -->
715 swift 1.4 <tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr>
716 neysx 1.12 <tr><ti><uri link="diskless-howto.xml">Diskless Guide</uri></ti></tr>
717 swift 1.4 <tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr>
718     <tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr>
719     <tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr>
720 swift 1.41 <tr><ti><uri link="udev-guide.xml">Gentoo udev Guide</uri></ti></tr>
721 swift 1.4 <tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr>
722     <tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr>
723 vapier 1.27 <tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></ti></tr>
724     <tr><ti><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></ti></tr>
725 swift 1.52 <tr><ti><uri link="gentoo-sparc-netboot-howto.xml">Gentoo/SPARC Netboot Howto</uri></ti></tr>
726 peitolm 1.59 <tr><ti><uri link="gentoo-sparc-obpreference.xml">Gentoo SPARC OpenBoot PROM Reference Guide</uri></ti></tr>
727 swift 1.57 <tr><ti><uri link="quick-samba-howto.xml">Quick Samba HOWTO</uri></ti></tr>
728 swift 1.4 <tr><th>Desktop Related Documentation</th></tr>
729     <tr><ti><uri link="desktop.xml">Desktop Configuration Guide</uri></ti></tr>
730     <tr><ti><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></ti></tr>
731     <tr><ti><uri link="java.xml">Java Guide</uri></ti></tr>
732     <tr><ti><uri link="guide-localization.xml">Localisation Guide</uri></ti></tr>
733     <tr><ti><uri link="dri-howto.xml">Direct Rendering Howto</uri></ti></tr>
734     <tr><ti><uri link="ati-faq.xml">ATI FAQ</uri></ti></tr>
735 swift 1.61 <tr><ti><uri link="xorg-config.xml">XOrg Configuration HOWTO</uri></ti></tr>
736 swift 1.62 <tr><ti><uri link="kde-config.xml">KDE Configuration HOWTO</uri></ti></tr>
737 swift 1.63 <tr><ti><uri link="gnome-config.xml">GNOME Configuration HOWTO</uri></ti></tr>
738 swift 1.4 <tr><ti><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></ti></tr>
739     <tr><ti><uri link="vi-guide.xml">Vi Guide</uri></ti></tr>
740 swift 1.14 <tr><ti><uri link="gnupg-user.xml">GnuPG User Guide</uri></ti></tr>
741 swift 1.4 <tr><ti><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></ti></tr>
742     <tr><ti><uri link="cvs-tutorial.xml">CVS Tutorial</uri></ti></tr>
743     <tr><th>Gentoo Development Documentation</th></tr>
744     <tr><ti><uri link="policy.xml">Gentoo Linux Development Policy</uri></ti></tr>
745 swift 1.16 <!-- <tr><ti><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></ti></tr> -->
746 swift 1.4 <tr><ti><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr>
747     <tr><ti><uri link="gentoo-howto.xml">Ebuild Howto</uri></ti></tr>
748     <tr><ti><uri link="eclass-howto.xml">Eclass Howto</uri></ti></tr>
749     <tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr>
750 swift 1.25 <tr><ti><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></ti></tr>
751 swift 1.26 <tr><ti><uri link="metadata.xml">Metadata document</uri></ti></tr>
752 neysx 1.45 <tr><ti><uri link="xml-guide.xml">GuideXML Guide</uri></ti></tr>
753     <tr><ti><uri link="doc-tipsntricks.xml">Doc Developers' Tips &amp; Tricks</uri></ti></tr>
754 swift 1.4 <tr><th>Other Documentation</th></tr>
755     <tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr>
756     <tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr>
757     </table>
758    
759     </body>
760 swift 1.32 </section>
761 swift 1.4 </chapter>
762 swift 1.1 </mainpage>

  ViewVC Help
Powered by ViewVC 1.1.20