/[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.37 Revision 1.51
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.37 2004/03/01 01:58:34 pylon Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/index.xml,v 1.51 2004/04/11 15:39:24 swift 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.15</version> 19 <version>2.21</version>
20 <date>February 26, 2004</date> 20 <date>April 11, 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>
96<p> 96<p>
97Our documentation is available in several languages. Although not all 97Our documentation is available in several languages. Although not all
98documents are translated, we do our best to keep them all up to date and 98documents are translated, we do our best to keep them all up to date and
99provide our users with as much translated documentation as possible. If 99provide our users with as much translated documentation as possible. If
100you want to help with our translation efforts, please contact <mail 100you want to help with our translation efforts, please contact <mail
101link="svyatogor@gentoo.org">Sergey Kuleshov</mail> who is in charge of 101link="neysx@gentoo.org">Xavier Neys</mail> who is in charge of
102the internationalisation efforts. 102the internationalisation efforts.
103</p> 103</p>
104 104
105</body> 105</body>
106</section> 106</section>
132<title>Gentoo Handbook</title> 132<title>Gentoo Handbook</title>
133<body> 133<body>
134 134
135<p> 135<p>
136The Gentoo Documentation Project has started with the <uri 136The Gentoo Documentation Project has started with the <uri
137link="handbook/handbook.xml">Gentoo Handbook</uri> development. Currently, the 137link="handbook/">Gentoo Handbook</uri> development. Currently, the
138first two parts (<uri link="handbook/handbook.xml?part=1">Installing 138first two parts (<uri link="handbook/handbook-x86.xml?part=1">Installing
139Gentoo</uri> and <uri link="handbook/handbook.xml?part=2">Working with 139Gentoo</uri> and <uri link="handbook/handbook-x86.xml?part=2">Working with
140Gentoo</uri>) are finished and have reached the "official" stage. Users are 140Gentoo</uri>) are finished and have reached the "official" stage. Users are
141encouraged to use the installation instructions from the Handbook and <uri 141encouraged 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 142link="http://bugs.gentoo.org/enter_bug.cgi?product=Docs-user">bug</uri> us with
143their experience (please use the <e>Handbook</e> component). 143their experience (please use the <e>Handbook</e> component).
144</p> 144</p>
145 145
146<p> 146<p>
147More information can be found on the <uri link="handbook/index.xml">Gentoo 147More information can be found on the <uri link="handbook/">Gentoo
148Handbook Effort</uri> homepage. 148Handbook Effort</uri> homepage.
149</p> 149</p>
150 150
151</body> 151</body>
152</section> 152</section>
171<section> 171<section>
172<title>Installation Guides</title> 172<title>Installation Guides</title>
173<body> 173<body>
174 174
175<p> 175<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 176The 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 177Handbook</uri></b> explains how to install Gentoo on your system. Each
179instructions for all users, all architectures. 178architecture-specific version contains instructions for all users.
180</p>
181
182<!-- unlinked until updated
183<p> 179</p>
184For experienced users we also have a <b><uri 180
181<p>
182For experienced users we also have Quick Installation Reference documents:
183</p>
184
185<ul>
185link="gentoo-x86-quickinstall.xml">x86 Quick Installation Reference</uri></b>. 186 <li><b><uri link="gentoo-x86-quickinstall.xml">x86 Quick Installation Reference</uri></b></li>
186</p> 187 <li><b><uri link="gentoo-sparc-quickinstall.xml">Sparc Quick Installation Reference</uri></b></li>
187--> 188</ul>
189
188<p> 190<p>
189Alpha-users are probably also interested in our <b><uri 191Alpha-users are probably also interested in our <b><uri
190link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></b>, which 192link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></b>, which
191explains how to set up the Compaq Tools package for Gentoo Alpha users. 193explains how to set up the Compaq Tools package for Gentoo Alpha users.
192</p> 194</p>
202environment doesn't permit them to boot from a LiveCD. To anticipate their 204environment doesn't permit them to boot from a LiveCD. To anticipate their
203environments we provide the <b><uri link="altinstall.xml">Alternative 205environments we provide the <b><uri link="altinstall.xml">Alternative
204Installation Guide</uri></b> which lists the installation steps needed to install 206Installation Guide</uri></b> which lists the installation steps needed to install
205Gentoo from another medium (distribution, bootable CD, network boot, etc.). 207Gentoo from another medium (distribution, bootable CD, network boot, etc.).
206</p> 208</p>
207<!-- Doc needs updating for LVM2 and 2.6 kernels (also 2.4 <-> 2.6 coop) 209
208<p> 210<p>
209Users interested in using LVM should read up our <b><uri link="lvm.xml">LVM 211Users interested in using LVM2 should read up our <b><uri link="lvm2.xml">LVM2
210Guide</uri></b> (implemented in the Gentoo Handbook) which explains what steps 212Guide</uri></b> which explains the steps required to get your LVM2 scheme up
211you have to go through to get your LVM scheme up and running. 213and running.
214</p>
215
212</p> 216<p>
213--> 217As our installation instructions allow for great flexibility, there are many
218tips and tricks that can be persued during the installation. We have a <b><uri
219link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Installation Tips 'n
220Tricks</uri></b> document online (which also contains interesting Tips 'n Tricks
221for other architectures).
222</p>
223
214<p> 224<p>
215The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade 225The <b><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade
216Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to 226Guide</uri></b> explains how to upgrade your Gentoo Linux 1.x systems to
217Gentoo Linux 1.4. 227Gentoo Linux 1.4.
218</p> 228</p>
237Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc. 247Gentoo Gentoo. This includes our init-system, Portage, USE-flags etc.
238</p> 248</p>
239 249
240<p> 250<p>
241The Gentoo Handbook has a part on <uri 251The Gentoo Handbook has a part on <uri
242link="handbook/handbook.xml?part=2">Working with Gentoo</uri> which contains 252link="handbook/handbook-x86.xml?part=2">Working with Gentoo</uri> which contains
243information on Portage, USE flags, the Gentoo Init system and environment 253information on Portage, USE flags, the Gentoo Init system and environment
244variables. 254variables.
245</p> 255</p>
246 256
247</body> 257</body>
249<section> 259<section>
250<title>Portage and Related Documentation</title> 260<title>Portage and Related Documentation</title>
251<body> 261<body>
252 262
253<p> 263<p>
254The <b><uri link="handbook/handbook.xml?part=2&amp;chap=2">Portage and 264The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and
255Software</uri></b> chapter in the Gentoo Handbook briefly covers how to keep 265Software</uri></b> chapter in the Gentoo Handbook briefly covers how to keep
256your packages up to date and how to maintain your installed software. In other 266your packages up to date and how to maintain your installed software. In other
257words, this chapter tells you how to use <c>emerge</c>. 267words, this chapter tells you how to use <c>emerge</c>.
258</p> 268</p>
259 269
264to installing and maintaining packages using the Portage system. It is 274to installing and maintaining packages using the Portage system. It is
265far more extended than the Portage User Guide. 275far more extended than the Portage User Guide.
266</p> 276</p>
267 277
268<p> 278<p>
269The <b><uri link="handbook/handbook.xml?part=2&amp;chap=1">USE Flags</uri></b> 279The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></b>
270chapter in the Gentoo Handbook introduces you to the ultimate 280chapter in the Gentoo Handbook introduces you to the ultimate
271tool for customizing Gentoo -- USE flags. This howto helps you decide which 281tool for customizing Gentoo -- USE flags. This howto helps you decide which
272USE flags you need. It also describes the use of <c>etcat</c> to receive 282USE flags you need. It also describes the use of <c>etcat</c> to receive
273more verbose information regarding USE-flags on a package. 283more verbose information regarding USE-flags on a package.
274</p> 284</p>
278<section> 288<section>
279<title>Configuring Gentoo</title> 289<title>Configuring Gentoo</title>
280<body> 290<body>
281 291
282<p> 292<p>
283The <b><uri link="handbook/handbook.xml?part=2&amp;chap=6">Environment 293The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment
284Variables</uri></b> chapter in the Gentoo Handbook explains how to manage 294Variables</uri></b> chapter in the Gentoo Handbook explains how to manage
285environment variables (such as <path>$PATH</path>) and the dynamic linker 295environment variables (such as <path>$PATH</path>) and the dynamic linker
286cache easily. 296cache easily.
287</p> 297</p>
288 298
289<p> 299<p>
290The <b><uri link="handbook/handbook.xml?part=2&amp;chap=5">Initscripts</uri></b> 300The <b><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></b>
291chapter in the Gentoo Handbook details our system 301chapter in the Gentoo Handbook details our system
292startup and service management scripts. Besides the regular 302startup and service management scripts. Besides the regular
293initscript-related items it also covers initscript dependencies and 303initscript-related items it also covers initscript dependencies and
294support for virtuals. 304support for virtuals.
295</p> 305</p>
350Gentoo Linux. IPv6 is the next Internet Protocol and is gaining 360Gentoo Linux. IPv6 is the next Internet Protocol and is gaining
351popularity widely. 361popularity widely.
352</p> 362</p>
353 363
354<p> 364<p>
355The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use User-Mode 365The <b><uri link="uml.xml">User Mode Linux Guide</uri></b> shows how to use
356Linux under Gentoo Linux. User Mode Linux (UML) provides a nice feature 366User-Mode Linux under Gentoo Linux. User Mode Linux (UML) provides a nice
357for Linux: Running Linux inside Linux (inside Linux inside Linux ...). 367feature for Linux: Running Linux inside Linux (inside Linux inside Linux ...).
358With UML, you can easily create virtual setups. 368With UML, you can easily create virtual setups.
369</p>
370
371<p>
372The <b><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></b> show you
373how to set up a UML installation with SELinux support.
359</p> 374</p>
360 375
361</body> 376</body>
362</section> 377</section>
363<section> 378<section>
392</p> 407</p>
393 408
394<p> 409<p>
395The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works 410The <b><uri link="devfs-guide.xml">DevFS Guide</uri></b> describes how DevFS works
396and how to administer it. 411and how to administer it.
412</p>
413
414<p>
415The <b><uri link="udev-guide.xml">Gentoo udev Guide</uri></b> describes the new
416device file management (using udev) which replaces DevFS and informs the reader
417how udev is integrated in Gentoo.
397</p> 418</p>
398 419
399<p> 420<p>
400The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive 421The <b><uri link="printing-howto.xml">Printing Howto</uri></b> is a comprehensive
401guide to Gentoo and printing. 422guide to Gentoo and printing.
576</p> 597</p>
577 598
578<p> 599<p>
579The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML 600The <b><uri link="xml-guide.xml">GuideXML Guide</uri></b> documents the XML
580format used in Gentoo Linux's web-based documentation. 601format used in Gentoo Linux's web-based documentation.
602</p>
603
604<p>
605The <b><uri link="doc-tipsntricks.xml">Doc Developers' Tips &amp;
606Tricks</uri></b> contains some pointers for documentation developers.
581</p> 607</p>
582 608
583</body> 609</body>
584</section> 610</section>
585</chapter> 611</chapter>
616<table> 642<table>
617<tr><th>Frequently Asked Questions</th></tr> 643<tr><th>Frequently Asked Questions</th></tr>
618<tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr> 644<tr><ti><uri link="faq.xml">Gentoo FAQ</uri></ti></tr>
619<tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr> 645<tr><ti><uri link="gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri></ti></tr>
620<tr><th>Installation Related Documentation</th></tr> 646<tr><th>Installation Related Documentation</th></tr>
621<tr><ti><uri link="handbook/handbook.xml?part=1">Installing Gentoo</uri></ti></tr> 647<tr><ti><uri link="handbook/">Gentoo Handbook</uri></ti></tr>
622<!--<tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Rerefence</uri></ti></tr>--> 648<tr><ti><uri link="gentoo-x86-quickinstall.xml">Gentoo x86 Quick Installation Rerefence</uri></ti></tr>
649<tr><ti><uri link="gentoo-sparc-quickinstall.xml">Gentoo sparc Quick Installation Rerefence</uri></ti></tr>
623<tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr> 650<tr><ti><uri link="gentoo-alpha-compaq-tools.xml">Compaq Alpha Tools Guide</uri></ti></tr>
624<tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr> 651<tr><ti><uri link="altinstall.xml">Alternative Installation Guide</uri></ti></tr>
625<!--<tr><ti><uri link="lvm.xml">LVM Guide</uri></ti></tr>--> 652<tr><ti><uri link="lvm2.xml">LVM2 Guide</uri></ti></tr>
653<tr><ti><uri link="gentoo-x86-tipsntricks.xml">Gentoo/x86 Tips 'n Tricks Document</uri></ti></tr>
626<tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr> 654<tr><ti><uri link="new-upgrade-to-gentoo-1.4.xml">Gentoo Linux 1.4 Upgrade Guide</uri></ti></tr>
627<tr><ti><uri link="genkernel.xml">Genkernel Guide</uri></ti></tr> 655<tr><ti><uri link="genkernel.xml">Genkernel Guide</uri></ti></tr>
628<tr><th>Gentoo System Documentation</th></tr> 656<tr><th>Gentoo System Documentation</th></tr>
629<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=2">Portage and Software</uri></ti></tr> 657<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=2">Portage and Software</uri></ti></tr>
630<tr><ti><uri link="portage-manual.xml">Portage Manual Guide</uri></ti></tr> 658<tr><ti><uri link="portage-manual.xml">Portage Manual Guide</uri></ti></tr>
631<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=1">USE Flags</uri></ti></tr> 659<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=1">USE Flags</uri></ti></tr>
632<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=6">Environment Variables</uri></ti></tr> 660<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=6">Environment Variables</uri></ti></tr>
633<tr><ti><uri link="handbook/handbook.xml?part=2&amp;chap=5">Initscripts</uri></ti></tr> 661<tr><ti><uri link="handbook/handbook-x86.xml?part=2&amp;chap=5">Initscripts</uri></ti></tr>
634<tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr> 662<tr><ti><uri link="gentoo-kernel.xml">Gentoo Kernel Guide</uri></ti></tr>
635<tr><th>System Administration Documentation</th></tr> 663<tr><th>System Administration Documentation</th></tr>
636<tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr> 664<tr><ti><uri link="gentoo-security.xml">Gentoo Security Guide</uri></ti></tr>
637<tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr> 665<tr><ti><uri link="prelink-howto.xml">Prelinking Howto</uri></ti></tr>
638<tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr> 666<tr><ti><uri link="ipv6.xml">IPv6 Guide</uri></ti></tr>
639<tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr> 667<tr><ti><uri link="uml.xml">User Mode Linux Guide</uri></ti></tr>
668<tr><ti><uri link="selinux-uml-guide.xml">SELinux UML Guide</uri></ti></tr>
640<tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> 669<!-- <tr><ti><uri link="ldap-howto.xml">LDAP Authentification Howto</uri></ti></tr> -->
641<tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr> 670<tr><ti><uri link="openmosix-howto.xml">OpenMosix Guide</uri></ti></tr>
642<tr><ti><uri link="diskless-howto.xml">Diskless Guide</uri></ti></tr> 671<tr><ti><uri link="diskless-howto.xml">Diskless Guide</uri></ti></tr>
643<tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr> 672<tr><ti><uri link="ltsp.xml">LTSP Guide</uri></ti></tr>
644<tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr> 673<tr><ti><uri link="distcc.xml">DistCC Guide</uri></ti></tr>
645<tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr> 674<tr><ti><uri link="devfs-guide.xml">DevFS Guide</uri></ti></tr>
675<tr><ti><uri link="udev-guide.xml">Gentoo udev Guide</uri></ti></tr>
646<tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr> 676<tr><ti><uri link="printing-howto.xml">Printing Guide</uri></ti></tr>
647<tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr> 677<tr><ti><uri link="openafs.xml">OpenAFS Guide</uri></ti></tr>
648<tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></ti></tr> 678<tr><ti><uri link="virt-mail-howto.xml">Virtual/Mailhost Postfix Howto</uri></ti></tr>
649<tr><ti><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></ti></tr> 679<tr><ti><uri link="qmail-howto.xml">qmail/vpopmail Howto</uri></ti></tr>
650<tr><th>Desktop Related Documentation</th></tr> 680<tr><th>Desktop Related Documentation</th></tr>
663<tr><ti><uri link="policy.xml">Gentoo Linux Development Policy</uri></ti></tr> 693<tr><ti><uri link="policy.xml">Gentoo Linux Development Policy</uri></ti></tr>
664<!-- <tr><ti><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></ti></tr> --> 694<!-- <tr><ti><uri link="gentoo-release-policy.xml">Gentoo Linux Release Policy</uri></ti></tr> -->
665<tr><ti><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr> 695<tr><ti><uri link="doc-policy.xml">Gentoo Linux Documentation Policy</uri></ti></tr>
666<tr><ti><uri link="gentoo-howto.xml">Ebuild Howto</uri></ti></tr> 696<tr><ti><uri link="gentoo-howto.xml">Ebuild Howto</uri></ti></tr>
667<tr><ti><uri link="eclass-howto.xml">Eclass Howto</uri></ti></tr> 697<tr><ti><uri link="eclass-howto.xml">Eclass Howto</uri></ti></tr>
668<!--<tr><ti><uri link="stage-building-guide.xml">Stage Building Guide</uri></ti></tr>-->
669<tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr> 698<tr><ti><uri link="ebuild-submit.xml">Contributing Ebuilds Guide</uri></ti></tr>
670<tr><ti><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></ti></tr> 699<tr><ti><uri link="ebuild-mistakes.xml">Common Gentoo Ebuild Mistakes</uri></ti></tr>
671<tr><ti><uri link="metadata.xml">Metadata document</uri></ti></tr> 700<tr><ti><uri link="metadata.xml">Metadata document</uri></ti></tr>
701<tr><ti><uri link="xml-guide.xml">GuideXML Guide</uri></ti></tr>
702<tr><ti><uri link="doc-tipsntricks.xml">Doc Developers' Tips &amp; Tricks</uri></ti></tr>
672<tr><th>Other Documentation</th></tr> 703<tr><th>Other Documentation</th></tr>
673<tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr> 704<tr><ti><uri link="rsync.xml">Gentoo RSync Mirror</uri></ti></tr>
674<tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr> 705<tr><ti><uri link="source_mirrors.xml">Gentoo Distfiles Mirror</uri></ti></tr>
675</table> 706</table>
676 707

Legend:
Removed from v.1.37  
changed lines
  Added in v.1.51

  ViewVC Help
Powered by ViewVC 1.1.20