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.  Upgrade Guides

Gentoo 1.4 Upgrade Guide: A method for upgrading older Gentoo installations in place to Gentoo 1.4

Gentoo Upgrading Guide: This document explains how new Gentoo releases affect existing installs.

The complete Gentoo Linux 2.6 migration guide: This document will aid you in the process of migrating from Linux 2.4 to Linux 2.6, devfs to udev, OSS to ALSA, and LVM to LVM2.

Gentoo Linux Kernel Upgrade Guide: This document describes the process of upgrading your kernel from one release to another.

Baselayout and OpenRC Migration Guide: This guide shows you how to migrate from baselayout-1 to baselayout-2 and OpenRC.

Upgrading Apache: This document describes the procedure end-users should follow to safely upgrade their apache installation.

Upgrade guide to MySQL 4.* or 5.0.*: The MySQL herd is proud to announce that MySQL 5.0 will soon be found in Gentoo's stable tree. This document describes how to upgrade to MySQL 4.* and to 5.0.*.

"Unslotting" a slotted MySQL Installation: This document describes how to go back to an unslotted MySQL.

Gentoo GCC Upgrade Guide: This document will guide the user through the process of upgrading GCC.

Changing the CHOST variable: This document explains how to change the CHOST variable of an existing system.

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.6 Upgrade Guide: This guide shows you how to upgrade X.org to version 1.6.

Upgrading PHP: This document describes the procedure end-users should follow to safely upgrade their PHP installation.

Gentoo Java Upgrade Guide: This guide shows you how to upgrade Java to the new generation of Java on Gentoo, along with related concepts and tools.

Linux-PAM 0.99 upgrade guide: This guide will help you through the upgrade path for Linux-PAM from 0.78 (or older) to Linux-PAM 0.99.

TeX Live 2008 guide: This guide aims to show you how to install TeX Live 2008 on Gentoo, more specifically what you need to take care of if you already have a TeX distribution installed (like tetex or TeX Live 2005).