Gentoo Documentation Resources
Our documentation is also available in the following languages:
Simplified Chinese |
Welcome to the Gentoo Documentation Resources. This page will give you a quick
overview on the documentation we provide. Most documentation is released under
the Creative Commons -
Attribution / Share Alike license, an open documentation license. All
documentation should also be available in a printer-friendly format. To view
this document, append ?style=printable to the URL. You'll also find
a "Print" link on the top-right corner of each document.
If you find bugs in our documentation or have proposals, please use our Bugtracking System and fill in a bug report
for "Documentation" or "Doc Other". These bug reports will then be handled by
the Gentoo Documentation Project.
Our documentation is categorized and
hierarchically navigable. If you want a quick overview of all available
documentation without the additional information, please use our Documentation Listing page. We also have a full listing of all our documents with their
Gentoo Desktop Documentation Resources
Installing your Desktop
The X Server Configuration HOWTO:
Xorg is the X Window server which allows users to have a graphical
environment at their fingertips. This HOWTO explains what Xorg is, how to
install it and what the various configuration options are.
Gentoo Linux nVidia Guide:
Many Gentooists have an nVidia chipset on their system. nVidia provides specific
Linux drivers to boost the performance of your card. This guide informs you how
to install and configure these drivers.
Gentoo Linux ATI FAQ:
This FAQ should help users avoid some common installation and configuration
issues related to DRI and X11 for AMD/ATI boards.
Gentoo KDE Guide:
This guide demonstrates how to setup KDE SC using the ebuilds in the tree. Some
tools from the KDE team's git overlay (kde) may be used.
The GNOME Configuration HOWTO:
A frequently used environment is GNOME. This HOWTO tries to describe
all aspects of GNOME, including installation, configuration, usage, ...
The Fluxbox Configuration HOWTO:
This howto will show you how to set up the Fluxbox window manager for X11.
The Xfce Configuration Guide:
This guide provides an extensive introduction to Xfce, a fast, lightweight,
full-featured desktop environment.
The Openbox Configuration HOWTO:
This guide shows you how to install the Openbox window manager, and references
many potential programs to be used in conjunction with an Openbox session.
The LXDE Configuration HOWTO:
This guide introduces the user to LXDE, explains its components, and leads the
user through the installation.
Gnome 2.26 Upgrade Guide:
This is a guide for upgrading from GNOME 2.24.x to GNOME 2.26.x.
Migrating to Modular X HOWTO:
This guide shows you how to migrate to modular X.Org.
Xorg 1.5 Upgrade Guide:
This guide shows you how to upgrade X.org to version 1.5.
Xorg 1.6 Upgrade Guide:
This guide shows you how to upgrade X.org to version 1.6.
Xorg-server 1.8 Upgrade Guide:
This guide shows you how to upgrade X.org server to version 1.8.
Xorg-server 1.9 Upgrade Guide:
This guide shows you how to upgrade X.org server to version 1.9.
Xorg-server 1.10 Upgrade Guide:
This guide shows you how to upgrade the X.org server to version 1.10.
Gentoo libxcb 1.4 Upgrade Guide:
This guide shows how to upgrade from libxcb 126.96.36.199 and earlier to libxcb 1.4.
Gentoo ATI Migration guide:
This guide demonstrates how to migrate from the binary ATI driver to the
open-source driver (xf86-video-ati).
Configuring your Desktop
Gentoo Linux Bluetooth Guide:
This guide will explain how to successfully install a host Bluetooth device,
configure the kernel properly, explain all the possibilities that the Bluetooth
interconnection offers and how to have some fun with Bluetooth.
Using UTF-8 with Gentoo:
This guide shows you how to set up and use the UTF-8 Unicode character set with
your Gentoo Linux system, after explaining the benefits of Unicode and more
Gentoo Printing Guide:
This document covers the installation and maintenance of printers using CUPS and
Samba. It covers local installation and networked installations and you'll
also find instructions on using shared printers from other operating systems.
Gentoo Linux ALSA Guide:
This document helps a user setup ALSA on Gentoo Linux.
Gentoo Java Guide:
This guide will introduce you to Java and explain how to use Java with Gentoo
Gentoo Linux Localization Guide:
This guide should help users localize their Gentoo Linux distribution to any
European locale. It uses Germany as a case-study, since it is translated from
the German doc. Includes configuration for use of the euro currency symbol.
Hardware 3D Acceleration Guide:
This document is a guide to getting 3D acceleration working using the DRM with
Xorg in Gentoo Linux.
Power Management Guide:
In recent years, power management has become one of the differentiating
features in the quest for finding the perfect laptop. Yet, the operating system
must support the various power saving functionalities too. In this guide, we
cover how to setup your Gentoo installation so it manages power-hungry resources
in a flexible yet automated manner.
Using a Mouse within the Console:
This guide shows you how to set up and use GPM (the General Purpose Mouse
server) from within a command line interface. This is especially useful for new
Gentoo installations or for systems that cannot or do not use an X server.
Gentoo Linux Conky Howto:
This document describes how to install and configure the system monitor known
Application Specific Documentation
Nano Basics Guide:
This guide is meant to be a simple introduction to nano. It will quickly help
you to become familiar with its basic operation.
Learning vi -- the "cheatsheet" technique:
This guide will teach you how to use vi, using a cheat sheet method to
accelerate the learning process. This will be the first guide for vi,
catering to beginners.
GnuPG Gentoo User Guide:
This small guide will teach you the basics of using GnuPG, a tool for secure
QuickStart Guide to Mutt E-Mail:
This guide shows you how to begin using the powerful command line e-mail
Streaming Radio With SHOUTcast:
This guide will walk through the steps needed to setup a streaming radio server
with SHOUTcast Server and SHOUTcast Trans.
Gentoo Linux VDR Guide:
This guide shows you how to prepare Gentoo Linux for DVB and VDR.
Gentoo Linux Keychain Guide:
This document describes how to use ssh shared keys along with the keychain
program. It assumes basic knowledge of public key cryptography.