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 |