1.  Gentoo Documentation Resources

Available Languages

Our documentation is also available in the following languages:

Czech | English | French | German | Italian | Japanese | Polish | Simplified Chinese | Spanish

Introduction

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.

Documentation Repository

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 descriptions.

2.  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 1.1.90.2 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 specifically UTF-8.

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 Linux.

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 as Conky.

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 communication.

QuickStart Guide to Mutt E-Mail: This guide shows you how to begin using the powerful command line e-mail client mutt.

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.