Gentoo Archives: gentoo-dev-announce

From: "Tiziano Müller" <dev-zero@g.o>
To: gentoo-dev@l.g.o, gentoo-dev-announce <gentoo-dev-announce@l.g.o>
Subject: [gentoo-dev-announce] Upstream tags in metadata.xml (GLEP 46)
Date: Thu, 04 Feb 2010 23:46:09
Message-Id: 1265319421.14107.94.camel@localhost
1 While some people already discovered the upstream metadata tags, there
2 are only 8 ebuilds using them so far. Mostly I am to blame for that,
3 since I forgot to send out a proper announcement. While all the required
4 information can be found in the Developer Handbook [1], here is a short
5 summary:
6
7 The upstream tags are meant as a way to track information about
8 upstream, like:
9 - the upstream status (can make treecleaners lives easier)
10 - online documentation links (a shortcut for the user)
11 - not-so-obvious contact/bug-reporting information
12 - id of a hosting or indexing site (automated version bump checks)
13 - their alignment (mostly chaotic-neutral ;-)
14
15 An example (copied from GLEP 46 [2] itself):
16 <upstream>
17 <maintainer status="inactive">
18 <name>Foo Bar</name>
19 <email>foo@×××.bar</email>
20 </maintainer>
21 <maintainer status="active">
22 <name>Foo Gentoo</name>
23 <email>foo@g.o</email>
24 </maintainer>
25 <changelog>http://foo.bar/changelog.txt</changelog>
26 <doc lang="en">http://foo.bar/doc/index.html</doc>
27 <doc lang="de">http://foo.bar/doc/index.de.html</doc>
28 <bugs-to>https://bugs.foo.bar</bugs-to>
29 <remote-id type="freshmeat">foobar</remote-id>
30 <remote-id type="sourceforge">foobar</remote-id>
31 </upstream>
32
33 Please note:
34 - the <maintainer> tag in <upstream> is only for specifying an upstream
35 maintainer name and e-mail address and does not specify the ebuild
36 maintainer (although it may be the same if you decide to become
37 upstream).
38 - the type attribute for <remote-id> is currently one of (freshmeat|
39 sourceforge|cpan|vim), send a mail to gentoo-dev before adding
40 additional sites
41 - the data in the <remote-id> tags is an id which uniquely identifies
42 the project on that site:
43 - for type="vim": the script_id (example: 2586)
44 - for type="freshmeat": the project name (example: aria2)
45 - for type="sourceforge": the project name (example: liferea)
46 - for type="cpan": the module name (example: Pod-Index)
47
48 Regards,
49 Tiziano
50
51
52
53 [1]:
54 http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=4
55 [2]: http://www.gentoo.org/proj/en/glep/glep-0046.html
56
57
58 --
59 Tiziano Müller
60 Gentoo Linux Developer
61 Areas of responsibility:
62 Samba, PostgreSQL, CPP, Python, sysadmin, GLEP Editor
63 E-Mail : dev-zero@g.o
64 GnuPG FP : F327 283A E769 2E36 18D5 4DE2 1B05 6A63 AE9C 1E30

Attachments

File name MIME type
smime.p7s application/x-pkcs7-signature