LWN.net Logo

The Gentoo Development Guide

For anybody who has ever wondered what goes into the creation of a Gentoo package: the first version of the Gentoo Development Guide is now online. It contains a great deal of information on how to create ebuilds and the relevant policies.
(Log in to post comments)

The Gentoo Development Guide

Posted May 25, 2006 19:04 UTC (Thu) by tetromino (subscriber, #33846) [Link]

Heh, I find this part amusing:

-----------------------------

If a package is only supplied in autopackage format, you must not add it to the tree. If a package is supplied in autopackage format and some other sane standard format (for example a source tarball), use the other format only.

Autopackage packages are totally unsuitable for Gentoo systems for a large number of reasons:

* To even unpack the package, you must run arbitrary code supplied by an untrusted source.
* They install directly to the live filesystem.
* Their intrinsic dependency resolver is broken.
* They do not support the filesystem layout used by Gentoo.
* They do not support configuration protection.
* They can clobber arbitrary files on uninstall.
* The linking mechanism used is insufficiently flexible.
* The entire format is completely unportable and highly tied to x86 Linux systems.

Upstream are aware of these issues and have no desire to fix them — indeed, they pass off some of their most broken behaviour as 'features'.

The Gentoo Development Guide

Posted May 25, 2006 20:24 UTC (Thu) by minmax (guest, #37985) [Link]

Not really surprising when you look at the main author's name.
The guy got kicked from Gentoo for his behavior.
"They do not support the filesystem layout used by Gentoo." is quite funny
considering that manual does not look like any other Gentoo documentation.
Gentoo documentation is rather good. I wonder why this one looks so different.

The Gentoo Development Guide

Posted May 25, 2006 22:39 UTC (Thu) by bk (guest, #25617) [Link]

It's hosted on gentoo.org. How is the visual layout relevant to the validity of the text?

The Gentoo Development Guide

Posted May 28, 2006 2:17 UTC (Sun) by dirtyepic (subscriber, #30178) [Link]

The guide was developed largely outside of Gentoo by a group of developers unhappy with the current state (lack?) of policy and procedure documentation. Many parts of Gentoo are held together by unspoken rules and understandings and it can be hard for newcomers to learn the ropes. This doc is a step towards making it a bit easier and setting some of the more obvious things in writing.

The formatting and layout are due to the original author's, um..., strong dislike for the GuideXML format that Gentoo docs are done in. He has since "left" the project, so it's possible it'll be migrated over to GuideXML over time.

And yeah, ciaran's flamefests with the autopackage author on the gentoo-dev ml and forums are the stuff of legends.

Copyright © 2006, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds