/[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.3 - (hide annotations) (download) (as text)
Sat Oct 18 17:25:06 2003 UTC (11 years ago) by swift
Branch: MAIN
Changes since 1.2: +2 -1 lines
File MIME type: application/xml
Link quick installation reference

1 swift 1.1 <?xml version="1.0" encoding="UTF-8"?>
2     <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3     <mainpage id="docs">
4     <title>Gentoo Documentation Resources</title>
5     <author title="Author">
6     <mail link="drobbins@gentoo.org">Daniel Robbins</mail>
7     </author>
8     <author title="Editor">
9     <mail link="zhen@gentoo.org">John P. Davis</mail>
10     </author>
11     <author title="Editor">Colin Morey</author>
12     <author title="Editor">
13     <mail link="peesh@gentoo.org">Jorge Paulo</mail>
14     </author>
15     <author title="Editor">
16     <mail link="swift@gentoo.org">Sven Vermeulen</mail>
17     </author>
18 swift 1.2 <version>2.1</version>
19     <date>October 15, 2003</date>
20 swift 1.1
21     <chapter>
22     <title>Gentoo Documentation Resources</title>
23     <section>
24 swift 1.2 <title>Available Languages</title>
25     <body>
26    
27     <p>
28     This page (and documentation) is available in the following languages:
29     </p>
30    
31     <p>
32     <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> |
34     <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> |
36     <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> |
38     <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> |
40     <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> |
42     <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>
44     </p>
45    
46     </body>
47     </section>
48     <section>
49 swift 1.1 <title>Contents</title>
50     <body>
51    
52     <ul>
53     <li><uri link="#doc_chap1">Introduction</uri></li>
54     <li><uri link="#doc_chap2">Installation Related Resources</uri></li>
55     <li><uri link="#doc_chap3">Gentoo System Documentation</uri></li>
56     <li><uri link="#doc_chap4">System Administration Documentation</uri></li>
57     <li><uri link="#doc_chap5">Desktop Related Documentation</uri></li>
58     <li><uri link="#doc_chap6">Gentoo Development Documentation</uri></li>
59     <li><uri link="#doc_chap7">Other Documentation</uri></li>
60     </ul>
61    
62     </body>
63     </section>
64     <section>
65     <title>Introduction</title>
66     <body>
67    
68     <p>
69     Welcome to the Gentoo Documentation Resources. This page will give you a
70     quick overview on the documentation we provide. Most documentation is
71     released under the <uri
72     link="http://creativecommons.org/licenses/by-sa/1.0">Creative Commons -
73     Attribution / Share Alike</uri> license, an open documentation license. All
74     documentation should also be available in a printer-friendly format. To view
75     this document, append <path>?style=printable</path> to the URL.
76     </p>
77    
78     <p>
79     If you find bugs in our documentation or have proposals, please use our
80     <uri link="http://bugs.gentoo.org">Bugtracking System</uri> and fill in
81     a bug report for "Docs-developer" or "Docs-user". These bugreports will
82     then be handled by the <uri
83     link="http://www.gentoo.org/proj/en/gdp">Gentoo Documentation
84     Project</uri>.
85     </p>
86    
87     </body>
88     </section>
89     <section>
90     <title>Internationalisation Effort</title>
91     <body>
92    
93     <p>
94     Our documentation is available in several languages. Although not all
95     documents are translated, we do our best to keep them all up to date and
96     provide our users with as much translated documentation as possible. If
97     you want to help with our translation efforts, please contact <mail
98     link="svyatogor@gentoo.org">Sergey Kuleshov</mail> who is in charge of
99     the internationalisation efforts.
100     </p>
101    
102     </body>
103     </section>
104     <section>
105     <title>Frequently Asked Questions</title>
106     <body>
107    
108     <p>
109     As with every major project Gentoo has a FAQ too. We have first and foremost
110     two official FAQs maintained by the Gentoo Documentation Project:
111     </p>
112    
113     <ul>
114     <li>The <b><uri link="faq.xml">Gentoo FAQ</uri></b> answers Frequently Asked Questions
115     about Gentoo Linux with focus on x86 platforms.</li>
116     <li>The <b><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></b> answers Frequently
117     Asked Questions about Gentoo Linux on the PowerPC platform.</li>
118     </ul>
119    
120     <p>
121     Furthermore we have a very extensive collection of FAQs on our <uri
122     link="http://forums.gentoo.org">forums</uri>. To view those, go to
123     <uri>http://forums.gentoo.org/viewforum.php?f=40</uri>.
124     </p>
125    
126     </body>
127     </section>
128     </chapter>
129    
130     <chapter>
131     <title>Installation Related Resources</title>
132     <section>
133     <title>Introduction</title>
134     <body>
135    
136     <p>
137     The installation related documentation provide information that can be usefull
138     during the installation of Gentoo Linux. This includes architecture-related
139     installation resources and tutorials that are to be followed during the
140     installation (such as LVM).
141     </p>
142    
143     </body>
144     </section>
145     <section>
146     <title>Installation Guides</title>
147     <body>
148    
149     <p>
150     The installation guides step you through the process of installing Gentoo
151     Linux 1.4. We support various installation approaches, depending on how much
152     of the system you want to custom-build from scratch.
153     </p>
154    
155     <p>
156     The installation guides are available for the following architectures:
157     </p>
158    
159     <table>
160     <tr>
161     <ti>x86</ti>
162     <ti><b><uri link="gentoo-x86-install.xml">Online</uri></b></ti>
163     <ti><b><uri link="gentoo-x86-install.xml?style=printable">Printer Friendly</uri></b></ti>
164     </tr>
165     <tr>
166     <ti>Alpha</ti>
167     <ti><b><uri link="gentoo-alpha-install.xml">Online</uri></b></ti>
168     <ti><b><uri link="gentoo-alpha-install.xml?style=printable">Printer Friendly</uri></b></ti>
169     </tr>
170     <tr>
171     <ti>HPPA</ti>
172     <ti><b><uri link="gentoo-hppa-install.xml">Online</uri></b></ti>
173     <ti><b><uri link="gentoo-hppa-install.xml?style=printable">Printer Friendly</uri></b></ti>
174     </tr>
175     <tr>
176     <ti>PPC</ti>
177     <ti><b><uri link="gentoo-ppc-install.xml">Online</uri></b></ti>
178     <ti><b><uri link="gentoo-ppc-install.xml?style=printable">Printer Friendly</uri></b></ti>
179     </tr>
180     <tr>
181     <ti>Sparc</ti>
182     <ti><b><uri link="gentoo-sparc-install.xml">Online</uri></b></ti>
183     <ti><b><uri link="gentoo-sparc-install.xml?style=printable">Printer Friendly</uri></b></ti>
184     </tr>
185     </table>
186    
187     <p>
188     Most users will probably need the <b><uri link="gentoo-x86-install.xml">x86
189 swift 1.3 Installation Guide</uri></b>. For experienced users we also have a <b><uri
190     link="gentoo-x86-quickinstall.xml">x86 Quick Installation Reference</uri></b>.
191 swift 1.1 </p>
192    
193     <p>
194     Alpha-users are probably also interested in our <b><uri
195     link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></b>, which
196     explains how to set up the Compaq Tools package for Gentoo Alpha users.
197     </p>
198    
199     </body>
200     </section>
201     <section>
202     <title>Other Installation Related Documentation</title>
203     <body>
204    
205     <p>
206     For some people, the installation guide above doesn't suffice since their
207     environment doesn't permit them to boot from a LiveCD. To anticipate their
208     environments we provide the <b><uri link="altinstall.xml">Alternative
209     Installation Guide</uri></b> which lists the installation steps needed to install
210     Gentoo from another medium (distribution, bootable CD, network boot, etc.).
211     </p>
212    
213     <p>
214     Users interested in using LVM should read up our <b><uri link="lvm.xml">LVM
215     Guide</uri></b> which explains what steps you have to go through to get your
216     LVM scheme up and running.
217     </p>
218    
219     <p>
220     The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade
221     Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to
222     Gentoo Linux 1.4.
223     </p>
224    
225     </body>
226     </section>
227     </chapter>
228    
229     <chapter>
230     <title>Gentoo System Documentation</title>
231     <section>
232     <title>Introduction</title>
233     <body>
234    
235     <p>
236     The Gentoo System Documentation contains several guides about what makes
237     Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc.
238     </p>
239    
240     </body>
241     </section>
242     <section>
243     <title>Portage and Related Documentation</title>
244     <body>
245    
246     <p>
247     The <b><uri link="portage-user.xml">Portage User Guide</uri></b> briefly covers how
248     to keep your packages up to date and how to maintain your installed software.
249     In other words: this guide tells you how to use <c>emerge</c>.
250     </p>
251    
252     <p>
253     The <b><uri link="portage-manual.xml">Portage Manual</uri></b> provides a general
254     overview of Portage, detailed configuration information and an end user guide
255     to installing and maintaining packages using the Portage system. It is
256     far more extended than the Portage User Guide.
257     </p>
258    
259     <p>
260     The <b><uri link="use-howto.xml">USE Howto</uri></b> introduces you to the ultimate
261     tool for customizing Gentoo -- USE flags. This howto helps you decide which
262     USE flags you need. It also describes the use of <c>etcat</c> to receive
263     more verbatim information regarding USE-flags on a package.
264     </p>
265    
266     </body>
267     </section>
268     <section>
269     <title>Configuring Gentoo</title>
270     <body>
271    
272     <p>
273     The <b><uri link="env.d-howto.xml">ENV.D Howto</uri></b> explains how to manage
274     environment variables (such as <path>$PATH</path>) and the dynamic linker
275     cache easily.
276     </p>
277    
278     <p>
279     The <b><uri link="rc-scripts.xml">RC-Script Guide</uri></b> details our system
280     startup and service management scripts. Besides the regular
281     initscript-related items it also covers initscript dependencies and
282     support for virtuals.
283     </p>
284    
285     </body>
286     </section>
287     <section>
288     <title>Gentoo Choices</title>
289     <body>
290    
291     <p>
292     The <b><uri link="gentoo-kernel.xml">Kernel Guide</uri></b> lists the various
293     kernel sources Gentoo provides. Most of these kernels are maintained by
294     the <uri link="http://www.gentoo.org/proj/en/kernel">Gentoo Kernel
295     Project</uri>.
296     </p>
297    
298     </body>
299     </section>
300     </chapter>
301    
302     <chapter>
303     <title>System Administration Documentation</title>
304     <section>
305     <title>Introduction</title>
306     <body>
307    
308     <p>
309     The System Administration Documentation contains tutorials and guides on how to
310     install, configure and/or manage certain aspects of system administration.
311     Although the focus is on Gentoo systems, several of these guides can very well
312     be used by non-Gentoo users.
313     </p>
314    
315     </body>
316     </section>
317     <section>
318     <title>General System Administration</title>
319     <body>
320    
321     <p>
322     The <b><uri link="gentoo-security.xml">Gentoo Security Guide</uri></b> explains how
323     to harden a Gentoo Linux system against intruders and attacks. It
324     contains general security information (securing services, designing firewalls,
325     using IDS, kernel security etc.). For even tighter hardening please
326     visit the <uri link="http://www.gentoo.org/proj/en/hardened">Gentoo
327     Hardened</uri> website.
328     </p>
329    
330     <p>
331     The <b><uri link="prelink-howto.xml">Prelinking Guide</uri></b> explains how to
332     enhance your system using prelink. With prelinking, bigger applications
333     start up faster.
334     </p>
335    
336     <p>
337     The <b><uri link="ipv6.xml">IPv6 Guide</uri></b> shows how to setup IPv6 under
338     Gentoo Linux. IPv6 is the next Internet Protocol and is gaining
339     popularity widely.
340     </p>
341    
342     <p>
343     The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use User-Mode
344     Linux under Gentoo Linux. User Mode Linux (UML) provides a nice feature
345     for Linux: Running Linux inside Linux (inside Linux inside Linux ...).
346     With UML, you can easily create virtual setups.
347     </p>
348    
349     </body>
350     </section>
351     <section>
352     <title>Specific Administration Guides</title>
353     <body>
354    
355     <p>
356     The <b><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></b> explains how
357     to administer user accounts centralised using OpenLDAP.
358     </p>
359    
360     <p>
361     The <b><uri link="openmosix-howto.xml">OpenMosix Howto</uri></b> describes step by
362     step how you can create a farm full of diskless openmosix nodes (a
363     cluster of several PCs).
364     </p>
365    
366     <p>
367     The <b><uri link="ltsp.xml">LTSP Guide</uri></b> explains how to setup a Linux
368     Terminal Server with Gentoo.
369     </p>
370    
371     <p>
372     The <b><uri link="distcc.xml">Distcc Guide</uri></b> informs you how to use distcc
373     for distributed compilations with Gentoo Linux.
374     </p>
375    
376     <p>
377     The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works
378     and how to administer it.
379     </p>
380    
381     <p>
382     The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive
383     guide to Gentoo and printing.
384     </p>
385    
386     <p>
387     The <b><uri link="openafs.xml">OpenAFS Guide</uri></b> documents the use and
388     installation of OpenAFS, a distributed network-based file sharing technology.
389     </p>
390    
391     <p>
392     The <b><uri link="virt-mail-howto.xml">Virtual/Mailhost Howto</uri></b> is the
393     essential guide for any mail administrator. It covers the use of MySQL for
394     virtual users, webbased e-mail software, mailinglist software etc.
395     </p>
396    
397     </body>
398     </section>
399     </chapter>
400    
401     <chapter>
402     <title>Desktop Related Documentation</title>
403     <section>
404     <title>Introduction</title>
405     <body>
406    
407     <p>
408     The Desktop Related Documentation contains our Desktop Configuration Guide
409     with several other desktop related documents, including several
410     application-specific guides.
411     </p>
412    
413     </body>
414     </section>
415     <section>
416     <title>Desktop Configuration</title>
417     <body>
418    
419     <p>
420     The <b><uri link="desktop.xml">Desktop Configuration Guide</uri></b> explains how to
421     set up a fully-functional Gentoo Linux desktop machine. This includes
422     configuring KDE/GNOME, Using e-mail, File Sharing (using Samba), etc.
423     </p>
424    
425     <p>
426     The <b><uri link="alsa-guide.xml">ALSA Configuration Guide</uri></b> is a
427     comprehensive guide on how to install and use ALSA (Advanced Linux Sound
428     Architecture).
429     </p>
430    
431     <p>
432     The <b><uri link="java.xml">Java Guide</uri></b> explains how Java is handled under
433     Gentoo Linux.
434     </p>
435    
436     <p>
437     The <b><uri link="guide-localization.xml">Localisation Guide</uri></b> explains how
438     to localise Gentoo Linux for non-English users.
439     </p>
440    
441     <p>
442     The <b><uri link="dri-howto.xml">Direct Rendering Howto</uri></b> explains how to get
443     3D acceleration working using XFree-DRM.
444     </p>
445    
446     <p>
447     The <b><uri link="ati-faq.xml">ATI FAQ</uri></b> provides the answers to frequently
448     asked questions regarding ATI graphical cards.
449     </p>
450    
451     </body>
452     </section>
453     <section>
454     <title>Application Specific Documentation</title>
455     <body>
456    
457     <p>
458     The <b><uri link="nano-basics-guide.xml">Nano Basics Guide</uri></b> leads by example
459     to explain the basics of Nano.
460     </p>
461    
462     <p>
463     The <b><uri link="vi-guide.xml">Vi Guide</uri></b> uses the cheatsheet method to
464     teach the basics of vi.
465     </p>
466    
467     <p>
468     The <b><uri link="gnupg-user.xml">GnuPG User Guide</uri></b> is the definitive guide
469     on GnuPG.
470     </p>
471    
472     <p>
473     The <b><uri link="guide-to-mutt.xml">Quickstart Guide to CLI E-mail Tools</uri></b>
474     explains how to use fetchmail, procmail, mutt, and nbsmtp.
475     </p>
476    
477     <p>
478     The <b><uri link="cvs-tutorial.xml">CVS Tutorial</uri></b> documents the basics of
479     using CVS, the Concurrent Versioning System.
480     </p>
481    
482     </body>
483     </section>
484     </chapter>
485    
486     <chapter>
487     <title>Gentoo Development Documentation</title>
488     <section>
489     <title>Introduction</title>
490     <body>
491    
492     <p>
493     Gentoo is a volunteer-driven distribution. It is therefor vital to have
494     high-quality development-related documentation available so that interested
495     users can easily learn how to help in the development of their favorite
496     distribution.
497     </p>
498    
499     </body>
500     </section>
501     <section>
502     <title>Gentoo Development Policies</title>
503     <body>
504    
505     <p>
506     The <b><uri link="policy.xml">Gentoo Linux Development Policy</uri></b> details
507     current policy for the creation of ebuilds.
508     </p>
509    
510     <p>
511     The <b><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></b>
512     details current policy for Gentoo Linux releases.
513     </p>
514    
515     <p>
516     The <b><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></b> details
517     current policy for the creation and editing of documentation.
518     </p>
519    
520     </body>
521     </section>
522     <section>
523     <title>Development Related Documentation</title>
524     <body>
525    
526     <p>
527     The <b><uri link="gentoo-howto.xml">Ebuild HOWTO</uri></b> explains how to create
528     ebuilds.
529     </p>
530    
531     <p>
532     The <b><uri link="eclass-howto.xml">Eclass HOWTO</uri></b> shows how to create
533     ebuilds that support OOP-like inheritance features.
534     </p>
535    
536     <p>
537     The <b><uri link="stage-building-guide.xml">Stage Building Guide</uri></b> details
538     the stage tarball creation process.
539     </p>
540    
541     <p>
542     The <b><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></b> explains
543     how to submit user-authored ebuilds.
544     </p>
545    
546     <p>
547     The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML format
548     used in Gentoo Linux's web-based documentation.
549     </p>
550    
551     </body>
552     </section>
553     </chapter>
554    
555     <chapter>
556     <title>Other Documentation</title>
557     <section>
558     <body>
559    
560     <ul>
561     <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>
562     <li><b><uri link="http://www.gentoo.org/main/en/about.xml">About</uri></b> the Gentoo Project.</li>
563     <li>Gentoo's <b><uri link="http://www.gentoo.org/main/en/contract.xml">Social Contract</uri></b>.</li>
564     <li>More on the <b><uri link="http://www.gentoo.org/proj/en/site.xml">XML projects</uri></b> Gentoo has gone through.</li>
565     <li>How to <b><uri link="rsync.xml">Mirror Gentoo : Rsync</uri></b>.</li>
566     <li>How to <b><uri link="source_mirrors.xml">Mirror Gentoo : Distfiles</uri></b>.</li>
567     <li>Gentoo Linux News (<uri link="http://www.gentoo.org/rdf/en/gentoo-news.rdf">RDF</uri>, <uri
568     link="http://purl.org/net/syndication/subscribe/?rss=http://www.gentoo.org/rdf/en/gentoo-news.rdf">Subscribe</uri>).</li>
569     </ul>
570    
571     </body>
572     </section>
573     </chapter>
574     </mainpage>

  ViewVC Help
Powered by ViewVC 1.1.20