| … | |
… | |
| 6 | PEP, see http://www.python.org/peps/pep-0001.html for instructions and links |
6 | PEP, see http://www.python.org/peps/pep-0001.html for instructions and links |
| 7 | to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! |
7 | to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! |
| 8 | --> |
8 | --> |
| 9 | <head> |
9 | <head> |
| 10 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
10 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| 11 | <meta name="generator" content="Docutils 0.3.0: http://docutils.sourceforge.net/" /> |
11 | <meta name="generator" content="Docutils 0.3.3: http://docutils.sourceforge.net/" /> |
| 12 | <title>GLEP 5 -- Extending metadata.xml</title> |
12 | <title>GLEP 5 -- Extending metadata.xml</title> |
| 13 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
13 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
| 14 | </head> |
14 | </head> |
| 15 | <body bgcolor="white"> |
15 | <body bgcolor="white"> |
| 16 | <table class="navigation" cellpadding="0" cellspacing="0" |
16 | <table class="navigation" cellpadding="0" cellspacing="0" |
| … | |
… | |
| 20 | <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" |
20 | <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" |
| 21 | border="0" width="150" height="35" /></a></td> |
21 | border="0" width="150" height="35" /></a></td> |
| 22 | <td class="textlinks" align="left"> |
22 | <td class="textlinks" align="left"> |
| 23 | [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] |
23 | [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] |
| 24 | [<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>] |
24 | [<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>] |
| 25 | [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0005.txt">GLEP Source</a></b>] |
25 | [<b><a href="./glep-0005.txt">GLEP Source</a></b>] |
| 26 | </td></tr></table> |
26 | </td></tr></table> |
| 27 | <div class="document"> |
27 | <div class="document"> |
| 28 | <table class="rfc2822 field-list" frame="void" rules="none"> |
28 | <table class="rfc2822 field-list" frame="void" rules="none"> |
| 29 | <col class="field-name" /> |
29 | <col class="field-name" /> |
| 30 | <col class="field-body" /> |
30 | <col class="field-body" /> |
| 31 | <tbody valign="top"> |
31 | <tbody valign="top"> |
| 32 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">5</td> |
32 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">5</td> |
| 33 | </tr> |
33 | </tr> |
| 34 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Extending metadata.xml</td> |
34 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Extending metadata.xml</td> |
| 35 | </tr> |
35 | </tr> |
| 36 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</td> |
36 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.3</td> |
| 37 | </tr> |
37 | </tr> |
| 38 | <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0005.txt?cvsroot=gentoo">2003/07/03 05:38:42</a></td> |
38 | <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs/xml/htdocs/proj/en/glep/glep-0005.txt?cvsroot=gentoo">2004/11/11 21:27:31</a></td> |
| 39 | </tr> |
39 | </tr> |
| 40 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Heinrich Wendel <sysop at heinospage.de>,</td> |
40 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Heinrich Wendel <sysop at heinospage.de>,</td> |
| 41 | </tr> |
41 | </tr> |
| 42 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> |
42 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td> |
| 43 | </tr> |
43 | </tr> |
| 44 | <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> |
44 | <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> |
| 45 | </tr> |
45 | </tr> |
| 46 | <tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td> |
46 | <tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0012.html">text/x-rst</a></td> |
| 47 | </tr> |
47 | </tr> |
| 48 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">02-Jul-2003</td> |
48 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">02-Jul-2003</td> |
|
|
49 | </tr> |
|
|
50 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">02-Jul-2003, 11-Nov-2004</td> |
| 49 | </tr> |
51 | </tr> |
| 50 | </tbody> |
52 | </tbody> |
| 51 | </table> |
53 | </table> |
| 52 | <hr /> |
54 | <hr /> |
| 53 | <div class="contents topic" id="contents"> |
55 | <div class="contents topic" id="contents"> |
| 54 | <p class="topic-title"><a name="contents">Contents</a></p> |
56 | <p class="topic-title first"><a name="contents">Contents</a></p> |
| 55 | <ul class="simple"> |
57 | <ul class="simple"> |
| 56 | <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract</a></li> |
58 | <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract</a></li> |
|
|
59 | <li><a class="reference" href="#status" id="id6" name="id6">Status</a></li> |
| 57 | <li><a class="reference" href="#motivation" id="id6" name="id6">Motivation</a></li> |
60 | <li><a class="reference" href="#motivation" id="id7" name="id7">Motivation</a></li> |
| 58 | <li><a class="reference" href="#specification" id="id7" name="id7">Specification</a></li> |
61 | <li><a class="reference" href="#specification" id="id8" name="id8">Specification</a></li> |
| 59 | <li><a class="reference" href="#rationale" id="id8" name="id8">Rationale</a></li> |
62 | <li><a class="reference" href="#rationale" id="id9" name="id9">Rationale</a></li> |
| 60 | <li><a class="reference" href="#backwards-compatibility" id="id9" name="id9">Backwards Compatibility</a></li> |
63 | <li><a class="reference" href="#backwards-compatibility" id="id10" name="id10">Backwards Compatibility</a></li> |
| 61 | <li><a class="reference" href="#reference-implementation" id="id10" name="id10">Reference Implementation</a></li> |
64 | <li><a class="reference" href="#reference-implementation" id="id11" name="id11">Reference Implementation</a></li> |
| 62 | <li><a class="reference" href="#references" id="id11" name="id11">References</a></li> |
65 | <li><a class="reference" href="#references" id="id12" name="id12">References</a></li> |
| 63 | <li><a class="reference" href="#copyright" id="id12" name="id12">Copyright</a></li> |
66 | <li><a class="reference" href="#copyright" id="id13" name="id13">Copyright</a></li> |
| 64 | </ul> |
67 | </ul> |
| 65 | </div> |
68 | </div> |
| 66 | <div class="section" id="abstract"> |
69 | <div class="section" id="abstract"> |
| 67 | <h1><a class="toc-backref" href="#id5" name="abstract">Abstract</a></h1> |
70 | <h1><a class="toc-backref" href="#id5" name="abstract">Abstract</a></h1> |
| 68 | <p>As the latest development in Gentoo and Portage added the metadata.xml file |
71 | <p>As the latest development in Gentoo and Portage added the metadata.xml file |
| 69 | to each package, which provides information about the package and it's |
72 | to each package, which provides information about the package and it's |
| 70 | maintainers, this GLEP proposes to extend this format in order to simplify |
73 | maintainers, this GLEP proposes to extend this format in order to simplify |
| 71 | the .ebuild format.</p> |
74 | the .ebuild format.</p> |
| 72 | </div> |
75 | </div> |
|
|
76 | <div class="section" id="status"> |
|
|
77 | <h1><a class="toc-backref" href="#id6" name="status">Status</a></h1> |
|
|
78 | <p>Timed out</p> |
|
|
79 | </div> |
| 73 | <div class="section" id="motivation"> |
80 | <div class="section" id="motivation"> |
| 74 | <h1><a class="toc-backref" href="#id6" name="motivation">Motivation</a></h1> |
81 | <h1><a class="toc-backref" href="#id7" name="motivation">Motivation</a></h1> |
| 75 | <p>The metadata.xml <a class="footnote-reference" href="#id4" id="id1" name="id1">[1]</a> standard was accepted and it already contains some |
82 | <p>The metadata.xml <a class="footnote-reference" href="#id4" id="id1" name="id1">[1]</a> standard was accepted and it already contains some |
| 76 | information about the packages (longdescription).</p> |
83 | information about the packages (longdescription).</p> |
| 77 | </div> |
84 | </div> |
| 78 | <div class="section" id="specification"> |
85 | <div class="section" id="specification"> |
| 79 | <h1><a class="toc-backref" href="#id7" name="specification">Specification</a></h1> |
86 | <h1><a class="toc-backref" href="#id8" name="specification">Specification</a></h1> |
| 80 | <p>Add the tags <description> <homepage> <license> to the metadata.xml <a class="footnote-reference" href="#id4" id="id2" name="id2">[1]</a> and |
87 | <p>Add the tags <description> <homepage> <license> to the metadata.xml <a class="footnote-reference" href="#id4" id="id2" name="id2">[1]</a> and |
| 81 | remove them from the .ebuild files. All ebuilds and the emerge -S feature |
88 | remove them from the .ebuild files. All ebuilds and the emerge -S feature |
| 82 | have to be changed to use the new format.</p> |
89 | have to be changed to use the new format.</p> |
| 83 | </div> |
90 | </div> |
| 84 | <div class="section" id="rationale"> |
91 | <div class="section" id="rationale"> |
| 85 | <h1><a class="toc-backref" href="#id8" name="rationale">Rationale</a></h1> |
92 | <h1><a class="toc-backref" href="#id9" name="rationale">Rationale</a></h1> |
| 86 | <p>The three tags description, homepage and license are mostly the same in all |
93 | <p>The three tags description, homepage and license are mostly the same in all |
| 87 | versions of an ebuild, but they must be added to each version. In order to |
94 | versions of an ebuild, but they must be added to each version. In order to |
| 88 | simplify the .ebuild format they can be moved to the new metadata.xml <a class="footnote-reference" href="#id4" id="id3" name="id3">[1]</a> file. |
95 | simplify the .ebuild format they can be moved to the new metadata.xml <a class="footnote-reference" href="#id4" id="id3" name="id3">[1]</a> file. |
| 89 | This would also allow different descriptions for different languages (lang |
96 | This would also allow different descriptions for different languages (lang |
| 90 | attribute) and there are no problems when a programm changes it license |
97 | attribute) and there are no problems when a programm changes it license |
| 91 | (restrict attribute).</p> |
98 | (restrict attribute).</p> |
| 92 | </div> |
99 | </div> |
| 93 | <div class="section" id="backwards-compatibility"> |
100 | <div class="section" id="backwards-compatibility"> |
| 94 | <h1><a class="toc-backref" href="#id9" name="backwards-compatibility">Backwards Compatibility</a></h1> |
101 | <h1><a class="toc-backref" href="#id10" name="backwards-compatibility">Backwards Compatibility</a></h1> |
| 95 | <p>As it will take some time to do the changes on every ebuild, portage should still |
102 | <p>As it will take some time to do the changes on every ebuild, portage should still |
| 96 | support the old format for some time.</p> |
103 | support the old format for some time.</p> |
| 97 | </div> |
104 | </div> |
| 98 | <div class="section" id="reference-implementation"> |
105 | <div class="section" id="reference-implementation"> |
| 99 | <h1><a class="toc-backref" href="#id10" name="reference-implementation">Reference Implementation</a></h1> |
106 | <h1><a class="toc-backref" href="#id11" name="reference-implementation">Reference Implementation</a></h1> |
| 100 | <p>not yet ...</p> |
107 | <p>not yet ...</p> |
| 101 | </div> |
108 | </div> |
| 102 | <div class="section" id="references"> |
109 | <div class="section" id="references"> |
| 103 | <h1><a class="toc-backref" href="#id11" name="references">References</a></h1> |
110 | <h1><a class="toc-backref" href="#id12" name="references">References</a></h1> |
| 104 | <table class="footnote" frame="void" id="id4" rules="none"> |
111 | <table class="footnote" frame="void" id="id4" rules="none"> |
| 105 | <colgroup><col class="label" /><col /></colgroup> |
112 | <colgroup><col class="label" /><col /></colgroup> |
| 106 | <tbody valign="top"> |
113 | <tbody valign="top"> |
| 107 | <tr><td class="label"><a name="id4">[1]</a></td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id2">2</a>, <a class="fn-backref" href="#id3">3</a>)</em> Gentoo Herds Project |
114 | <tr><td class="label"><a name="id4">[1]</a></td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id2">2</a>, <a class="fn-backref" href="#id3">3</a>)</em> Gentoo Herds Project |
| 108 | [<a class="reference" href="http://www.gentoo.org/proj/en/metastructure/herds/#doc_chap2">http://www.gentoo.org/proj/en/metastructure/herds/#doc_chap2</a>]</td></tr> |
115 | [<a class="reference" href="http://www.gentoo.org/proj/en/metastructure/herds/#doc_chap2">http://www.gentoo.org/proj/en/metastructure/herds/#doc_chap2</a>]</td></tr> |
| 109 | </tbody> |
116 | </tbody> |
| 110 | </table> |
117 | </table> |
| 111 | </div> |
118 | </div> |
| 112 | <div class="section" id="copyright"> |
119 | <div class="section" id="copyright"> |
| 113 | <h1><a class="toc-backref" href="#id12" name="copyright">Copyright</a></h1> |
120 | <h1><a class="toc-backref" href="#id13" name="copyright">Copyright</a></h1> |
| 114 | <p>This document has been placed in the public domain.</p> |
121 | <p>This document has been placed in the public domain.</p> |
| 115 | </div> |
122 | </div> |
| 116 | </div> |
123 | </div> |
| 117 | |
124 | |
| 118 | <hr class="footer"/> |
125 | <hr class="footer" /> |
| 119 | <div class="footer"> |
126 | <div class="footer"> |
| 120 | <a class="reference" href="glep-0005.txt">View document source</a>. |
127 | <a class="reference" href="glep-0005.txt">View document source</a>. |
| 121 | Generated on: 2003-07-29 00:12 UTC. |
128 | Generated on: 2004-11-11 21:20 UTC. |
| 122 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
129 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
| 123 | </div> |
130 | </div> |
| 124 | </body> |
131 | </body> |
| 125 | </html> |
132 | </html> |
| 126 | |
133 | |