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

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 <version>2.1</version>
19 <date>October 15, 2003</date>
20
21 <chapter>
22 <title>Gentoo Documentation Resources</title>
23 <section>
24 <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 <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 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 </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