[gentoo-dev] GLEP 34 (category metadata) implemented

[Ciaran McCreesh]

GLEP 34 (category metadata) [1] is now fully implemented. Well, I say
fully. Actually, it isn't, since I don't have write access to the
sec-policy directory. But that really isn't a problem, since only two
people actually care what's in there anyway, and one of them can't read.

Package maintainers, feel free to update the descriptions if you can
come up with something better. It's fairly likely you'll be able to add
in a couple more helpful sentences, since I never go anywhere near some
categories. If you're fluent in non-English, by all means add in other
languages, but only do this if you're actually sure you're going to
spell things properly -- this is why I stuck to English only...

If you're committing, **remember to use utf-8**. If your language uses
all kinds of weird accented characters, you could really screw things up
if you don't.

The correct way to commit a *category* metadata file at the moment is:
    xmllint --noout --valid metadata.xml
    glep31check metadata.xml
    cvs commit -m "blah blah" metadata.xml

You can get glep31check from [2]. It's just a little utf-8 checker.

As a result of this, and with a bit of help from vim7's built-in spell
checker, I now know how to spell miscellaneous correctly without having
to think about it.

There's nothing in the metadata docs [3] about it yet. But then, the
metadata docs are massively out of date anyway (we've had repoman
support for ages...). You can get everything you need from the GLEP and
the DTD -- any questions, just ask.

1: http://www.gentoo.org/proj/en/glep/glep-0034.html
2: http://dev.gentoo.org/~ciaranm/overlay/app-portage/glep31check/
3:
http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=4

-- 
Ciaran McCreesh : Gentoo Developer (Vim, Fluxbox, shell tools)
Mail            : ciaranm at gentoo.org
Web             : http://dev.gentoo.org/~ciaranm