GDP Status ReportThis 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 gentoo-doc@gentoo.org or to me personally. 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 http://www.gentoo.org/proj/en/gdp. This status mail will briefly discuss the following tasks, objectives and/or projects related to the GDP: Users who are seeking a distributed file system can look at our updated OpenAFS Guide for installation and configuration instructions of the powerful Open Andrew File System which got updated to the current release, and extended quite a bit with additional documented functions. Also, our KDE Split Ebuilds document has been updated with some information about the possible new build scheme that KDE 4 will use, and confcache (an improvement for repeated autoconf-generated configure script executions). The FAQ on how to unmerge older KDE versions has been moved out... Talking about KDE, our KDE Configuration Guide has been updated to reflect the stabilisation of KDE 3.4 in the Portage tree and, with that, the introduction of new KDE packages. The update also improves the hal and dbus descriptions. And that's not all, the guide now contains information about maintaining several KDE versions simultaneously and includes the instructions about deinstalling KDE which were previously in the KDE Split Ebuilds guide. Readers interested in virtualisation should really take a look at the updated User-Mode Linux Guide which gives some additional help with virtual networks within the run-linux-in-linux context. Upcoming support for the FreeBSD platform is on its way. This is clearly reflected upon the short guide to Gentoo/FreeBSD which is getting larger and larger; the last updates include more verbose installation instructions and kernel configuration instructions, amongst various smaller updates which keep the documentation up to par with the codebase. We now have a Gentoo GCC Upgrading Guide which replaces the old guide which was stored in the x86/Base Project space. We never said upgrading GCC is painless, but with guides like these it is just a matter of reading, learning and executing. Other documents that have been updated are:
3. Moving Stage1/Stage2 To Gentoo FAQ Historically, the Gentoo Handbook contained all the installation methods that were possible to obtain a Gentoo installed environment. At first, this included the Knoppix and other alternative installation instructions. Those were moved to the Alternative Installation Guide because they were interfering with the "regular" installation method that Gentoo promoted. Now, due to various bugs and, more importantly, because the instructions were (and still are) flawed under some circumstances, the bootstrapping and system-emerge steps (also known as the stage1 and stage2 installation procedures) have been moved to the Gentoo FAQ. The idea is to keep the Gentoo Handbook for the official installation instructions which are supported by the release engineering team and fully documented and maintained by the documentation project, while the other installation instructions are maintained by the documentation project but not official. Work is on the way to create a bootstrapping guide, detailing why bootstrapping is needed, when and how to create installation media for an unsupported platform, etc. People with knowledge about this subject and who are interested in providing feedback can take a look at the current draft and mail Sven Vermeulen with their much appreciated feedback. The MacOS Guide has been removed; people are now referred to the Portage for Darwin/Mac OS X project. The contents of this document, unless otherwise expressly stated, are licensed under the CC-BY-SA-2.5 license. The Gentoo Name and Logo Usage Guidelines apply. |
|