On Thursday 24 November 2005 14:51, Grant Goodyear wrote: > Assuming that they're reasonably well written, why not add them to The > Doc? For the same reason the doc born outside GDP: quick changes, for once. for example the xine mantainer's guide yesterday was changed "on the spot" when the TEXTRELs problem was found, both its and vlc's guides were changed as soon as I moved the patchsets in gentoo CVS. The point is to have maintainers update their notes as they do them. If a new release come up, I can quickly update the notes about it.
> Alternatively (and perhaps more usefully), what about permitting a > MaintainerNotes file in any cat/pkg directory where it would be useful? That would be quite every package, because there's no package "without notes". Also the simplest packages might have something that needs to be checked. And adding one more file to the tree, of considerable size for some cases (look at xine's guide, it's quite long) would be really bad. And I still think that something more elaborated than txt can help in writing notes about that.. I know that many people does not like GuideXML, but it's flexible enough for most of the needs of a packager's notes. Referring again to the xine's guide, you can find that all the useflags stated are in bold.. if someone wants to find out why a given useflag is threated in certain way, it's simple to spot it, it's not so simple when you have to do it with a plain text file. -- Diego "Flameeyes" Pettenò - http://dev.gentoo.org/~flameeyes/ Gentoo/ALT lead, Gentoo/FreeBSD, Video, AMD64, Sound, PAM, KDE
pgpKOVnNJcie4.pgp
Description: PGP signature
