| 1 | <?xml version="1.0" encoding="utf-8" ?> |
1 | <?xml version="1.0" encoding="utf-8" ?> |
| 2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
2 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| 3 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
3 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
| 4 | <!-- |
4 | |
| 5 | This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new |
|
|
| 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! |
|
|
| 8 | --> |
|
|
| 9 | <head> |
5 | <head> |
| 10 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
6 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| 11 | <meta name="generator" content="Docutils 0.2.8: http://docutils.sourceforge.net/" /> |
7 | <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" /> |
| 12 | <title>GLEP 5 -- Extending metadata.xml</title> |
8 | <title>GLEP 5 -- Extending metadata.xml</title> |
| 13 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
9 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
| 14 | </head> |
10 | </head> |
| 15 | <body bgcolor="white"> |
11 | <body bgcolor="white"> |
| 16 | <table class="navigation" cellpadding="0" cellspacing="0" |
12 | <table class="navigation" cellpadding="0" cellspacing="0" |
| … | |
… | |
| 22 | <td class="textlinks" align="left"> |
18 | <td class="textlinks" align="left"> |
| 23 | [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] |
19 | [<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>] |
20 | [<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>] |
21 | [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0005.txt">GLEP Source</a></b>] |
| 26 | </td></tr></table> |
22 | </td></tr></table> |
| 27 | <div class="document"> |
|
|
| 28 | <table class="rfc2822 field-list" frame="void" rules="none"> |
23 | <table class="rfc2822 docutils field-list" frame="void" rules="none"> |
| 29 | <col class="field-name" /> |
24 | <col class="field-name" /> |
| 30 | <col class="field-body" /> |
25 | <col class="field-body" /> |
| 31 | <tbody valign="top"> |
26 | <tbody valign="top"> |
| 32 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">5</td> |
27 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">5</td> |
| 33 | </tr> |
28 | </tr> |
| 34 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Extending metadata.xml</td> |
29 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Extending metadata.xml</td> |
| 35 | </tr> |
30 | </tr> |
| 36 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.1</td> |
31 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.3</td> |
| 37 | </tr> |
32 | </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/gentoo/xml/htdocs/proj/en/glep/glep-0005.txt">2003/07/02 22:53:51</a></td> |
33 | <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">2004/11/11 21:27:31</a></td> |
| 39 | </tr> |
34 | </tr> |
| 40 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Heinrich Wendel <sysop at heinospage.de>,</td> |
35 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Heinrich Wendel <sysop at heinospage.de>,</td> |
| 41 | </tr> |
36 | </tr> |
| 42 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> |
37 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td> |
| 43 | </tr> |
38 | </tr> |
| 44 | <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> |
39 | <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> |
| 45 | </tr> |
40 | </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> |
41 | <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> |
| 47 | </tr> |
42 | </tr> |
| 48 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">02-Jul-2003</td> |
43 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">02-Jul-2003</td> |
| 49 | </tr> |
44 | </tr> |
|
|
45 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">02-Jul-2003, 11-Nov-2004</td> |
|
|
46 | </tr> |
| 50 | </tbody> |
47 | </tbody> |
| 51 | </table> |
48 | </table> |
| 52 | <hr /> |
49 | <hr /> |
| 53 | <div class="contents topic" id="contents"> |
50 | <div class="contents topic"> |
| 54 | <p class="topic-title"><a name="contents">Contents</a></p> |
51 | <p class="topic-title first"><a id="contents" name="contents">Contents</a></p> |
| 55 | <ul class="simple"> |
52 | <ul class="simple"> |
| 56 | <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract</a></li> |
53 | <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract</a></li> |
|
|
54 | <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> |
55 | <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> |
56 | <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> |
57 | <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> |
58 | <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> |
59 | <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> |
60 | <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> |
61 | <li><a class="reference" href="#copyright" id="id13" name="id13">Copyright</a></li> |
| 64 | </ul> |
62 | </ul> |
| 65 | </div> |
63 | </div> |
| 66 | <div class="section" id="abstract"> |
64 | <div class="section"> |
| 67 | <h1><a class="toc-backref" href="#id5" name="abstract">Abstract</a></h1> |
65 | <h1><a class="toc-backref" href="#id5" id="abstract" name="abstract">Abstract</a></h1> |
| 68 | <p>As the latest development in Gentoo and Portage added the metadata.xml file |
66 | <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 |
67 | 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 |
68 | maintainers, this GLEP proposes to extend this format in order to simplify |
| 71 | the .ebuild format.</p> |
69 | the .ebuild format.</p> |
| 72 | </div> |
70 | </div> |
| 73 | <div class="section" id="motivation"> |
71 | <div class="section"> |
|
|
72 | <h1><a class="toc-backref" href="#id6" id="status" name="status">Status</a></h1> |
|
|
73 | <p>Timed out</p> |
|
|
74 | </div> |
|
|
75 | <div class="section"> |
| 74 | <h1><a class="toc-backref" href="#id6" name="motivation">Motivation</a></h1> |
76 | <h1><a class="toc-backref" href="#id7" id="motivation" 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 |
77 | <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> |
78 | information about the packages (longdescription).</p> |
| 77 | </div> |
79 | </div> |
| 78 | <div class="section" id="specification"> |
80 | <div class="section"> |
| 79 | <h1><a class="toc-backref" href="#id7" name="specification">Specification</a></h1> |
81 | <h1><a class="toc-backref" href="#id8" id="specification" 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 |
82 | <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 |
83 | remove them from the .ebuild files. All ebuilds and the emerge -S feature |
| 82 | have to be changed to use the new format.</p> |
84 | have to be changed to use the new format.</p> |
| 83 | </div> |
85 | </div> |
| 84 | <div class="section" id="rationale"> |
86 | <div class="section"> |
| 85 | <h1><a class="toc-backref" href="#id8" name="rationale">Rationale</a></h1> |
87 | <h1><a class="toc-backref" href="#id9" id="rationale" name="rationale">Rationale</a></h1> |
| 86 | <p>The three tags description, homepage and license are mostly the same in all |
88 | <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 |
89 | 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. |
90 | 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 |
91 | This would also allow different descriptions for different languages (lang |
| 90 | attribute) and there are no problems when a programm changes it license |
92 | attribute) and there are no problems when a programm changes it license |
| 91 | (restrict attribute).</p> |
93 | (restrict attribute).</p> |
| 92 | </div> |
94 | </div> |
| 93 | <div class="section" id="backwards-compatibility"> |
95 | <div class="section"> |
| 94 | <h1><a class="toc-backref" href="#id9" name="backwards-compatibility">Backwards Compatibility</a></h1> |
96 | <h1><a class="toc-backref" href="#id10" id="backwards-compatibility" 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 |
97 | <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> |
98 | support the old format for some time.</p> |
| 97 | </div> |
99 | </div> |
| 98 | <div class="section" id="reference-implementation"> |
100 | <div class="section"> |
| 99 | <h1><a class="toc-backref" href="#id10" name="reference-implementation">Reference Implementation</a></h1> |
101 | <h1><a class="toc-backref" href="#id11" id="reference-implementation" name="reference-implementation">Reference Implementation</a></h1> |
| 100 | <p>not yet ...</p> |
102 | <p>not yet ...</p> |
| 101 | </div> |
103 | </div> |
| 102 | <div class="section" id="references"> |
104 | <div class="section"> |
| 103 | <h1><a class="toc-backref" href="#id11" name="references">References</a></h1> |
105 | <h1><a class="toc-backref" href="#id12" id="references" name="references">References</a></h1> |
| 104 | <table class="footnote" frame="void" id="id4" rules="none"> |
106 | <table class="docutils footnote" frame="void" id="id4" rules="none"> |
| 105 | <colgroup><col class="label" /><col /></colgroup> |
107 | <colgroup><col class="label" /><col /></colgroup> |
| 106 | <tbody valign="top"> |
108 | <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 |
109 | <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> |
110 | [<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> |
111 | </tbody> |
| 110 | </table> |
112 | </table> |
| 111 | </div> |
113 | </div> |
| 112 | <div class="section" id="copyright"> |
114 | <div class="section"> |
| 113 | <h1><a class="toc-backref" href="#id12" name="copyright">Copyright</a></h1> |
115 | <h1><a class="toc-backref" href="#id13" id="copyright" name="copyright">Copyright</a></h1> |
| 114 | <p>This document has been placed in the public domain.</p> |
116 | <p>This document has been placed in the public domain.</p> |
| 115 | </div> |
117 | </div> |
|
|
118 | |
| 116 | </div> |
119 | </div> |
|
|
120 | <div class="footer"> |
|
|
121 | <hr class="footer" /> |
|
|
122 | <a class="reference" href="glep-0005.txt">View document source</a>. |
|
|
123 | Generated on: 2007-10-13 13:39 UTC. |
|
|
124 | 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. |
| 117 | |
125 | |
| 118 | <hr class="footer"/> |
|
|
| 119 | <div class="footer"> |
|
|
| 120 | <a class="reference" href="glep-0005.txt">View document source</a>. |
|
|
| 121 | Generated on: 2003-07-03 02:27 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. |
|
|
| 123 | </div> |
126 | </div> |
| 124 | </body> |
127 | </body> |
| 125 | </html> |
128 | </html> |
| 126 | |
129 | |