GDP Status Report
This is the status of the Gentoo Documentation Project. It will be posted
regularly, but not with a static frequency. All questions can be posted to
firstname.lastname@example.org or to
The Gentoo Documentation Project, from now on abbreviated to GDP, has its own
project page (just like almost all other Gentoo projects). You can find it at
This status mail will briefly discuss the following tasks, objectives and/or
projects related to the GDP:
New / Updated Documentation
The Gentoo Installation Tips 'n
Tricks document now has a section on copying over the LiveCD kernel
instead of compiling one yourself.
The Usermode Linux Guide has been improved
with information from various forum postings.
Users of cascading profiles might notice some changes to the system packages.
The removal of slocate and dhcpcd result in some updates to the Gentoo Handbook,
informing the reader to install those packages as well if he needs it.
We now have a document on Using NX on Gentoo
Linux, thanks to Stuart Herbert.
This has been added to the Desktop
The KDE Configuration Guide has been
extended with a FAQ section. This section currently holds one question regarding
slow start-up of KDE, a problem many users have reported over the past few
An overview of all fixed bugreports since the last status update can be found on Gentoo's bugtracking system.
Portage Part in Gentoo Handbook
The Gentoo Handbook now has a Working with Portage part
explaining Portage, Gentoo's Software Management Tool. Also, the Working with Gentoo part
has received some updates, such as a new chapter called A Portage
Introduction which contains the basic Portage commands every user needs to
These two parts are written with Portage 2.0.51 in mind.
Upcoming Meta Updates
After an interesting thread
on the documentation mailinglist, we will be working on two metadata related
aspects (which means: important for the documentation developers but barely
noticeable by the users at first):
First of all, we will extend the GuideXML syntax a bit to allow version/date
information inside the individual chapters of the Gentoo Handbook. Up until now,
this is handled by the parent index file but this has proven to be a rather
difficult working method.
Placing this information in the individual chapters we can increase the
flexibility towards our translators regarding handbook updates - whereas they
previously had to dig through the CVS mailinglist to find the updates, they can
now relie on the differences between the versions of individual chapters.
The second metadata related project introduces a metadata file which lists all
our documentation, both provided by the GDP itself and by the individual
projects. This metadata file should be flexible enough to allow automated
creation of index files, an improved management of translated files, a track
record of Gentoo documentation and much, much more.
More about this later.