/[gentoo]/xml/htdocs/proj/en/glep/glep-0005.html
Gentoo

Contents of /xml/htdocs/proj/en/glep/glep-0005.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (show annotations) (download) (as text)
Wed Jul 2 22:53:51 2003 UTC (11 years ago) by g2boojum
Branch: MAIN
File MIME type: text/html
New glep.

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">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
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>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 <meta name="generator" content="Docutils 0.2.8: http://docutils.sourceforge.net/" />
12 <title>GLEP 6 -- Extending metadata.xml</title>
13 <link rel="stylesheet" href="tools/glep.css" type="text/css" />
14 </head>
15 <body bgcolor="white">
16 <table class="navigation" cellpadding="0" cellspacing="0"
17 width="100%" border="0">
18 <tr><td class="navicon" width="150" height="35">
19 <a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
20 <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
21 border="0" width="150" height="35" /></a></td>
22 <td class="textlinks" align="left">
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>]
25 [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0006.txt">GLEP Source</a></b>]
26 </td></tr></table>
27 <div class="document">
28 <table class="rfc2822 field-list" frame="void" rules="none">
29 <col class="field-name" />
30 <col class="field-body" />
31 <tbody valign="top">
32 <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">6</td>
33 </tr>
34 <tr class="field"><th class="field-name">Title:</th><td class="field-body">Extending metadata.xml</td>
35 </tr>
36 <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.0</td>
37 </tr>
38 <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://cvs.gentoo.org/cgi-bin/viewcvs.cgi/gentoo/xml/htdocs/proj/en/glep/glep-0006.txt">2003/07/02 18:00:02</a></td>
39 </tr>
40 <tr class="field"><th class="field-name">Author:</th><td class="field-body">Heinrich Wendel &lt;sysop&#32;&#97;t&#32;heinospage.de&gt;,</td>
41 </tr>
42 <tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td>
43 </tr>
44 <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
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>
47 </tr>
48 <tr class="field"><th class="field-name">Created:</th><td class="field-body">02-Jul-2003</td>
49 </tr>
50 </tbody>
51 </table>
52 <hr />
53 <div class="contents topic" id="contents">
54 <p class="topic-title"><a name="contents">Contents</a></p>
55 <ul class="simple">
56 <li><a class="reference" href="#abstract" id="id5" name="id5">Abstract</a></li>
57 <li><a class="reference" href="#motivation" id="id6" name="id6">Motivation</a></li>
58 <li><a class="reference" href="#specification" id="id7" name="id7">Specification</a></li>
59 <li><a class="reference" href="#rationale" id="id8" name="id8">Rationale</a></li>
60 <li><a class="reference" href="#backwards-compatibility" id="id9" name="id9">Backwards Compatibility</a></li>
61 <li><a class="reference" href="#reference-implementation" id="id10" name="id10">Reference Implementation</a></li>
62 <li><a class="reference" href="#references" id="id11" name="id11">References</a></li>
63 <li><a class="reference" href="#copyright" id="id12" name="id12">Copyright</a></li>
64 </ul>
65 </div>
66 <div class="section" id="abstract">
67 <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
69 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
71 the .ebuild format.</p>
72 </div>
73 <div class="section" id="motivation">
74 <h1><a class="toc-backref" href="#id6" 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
76 information about the packages (longdescription).</p>
77 </div>
78 <div class="section" id="specification">
79 <h1><a class="toc-backref" href="#id7" name="specification">Specification</a></h1>
80 <p>Add the tags &lt;description&gt; &lt;homepage&gt; &lt;license&gt; 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
82 have to be changed to use the new format.</p>
83 </div>
84 <div class="section" id="rationale">
85 <h1><a class="toc-backref" href="#id8" name="rationale">Rationale</a></h1>
86 <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
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.
89 This would also allow different descriptions for different languages (lang
90 attribute) and there are no problems when a programm changes it license
91 (restrict attribute).</p>
92 </div>
93 <div class="section" id="backwards-compatibility">
94 <h1><a class="toc-backref" href="#id9" 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
96 support the old format for some time.</p>
97 </div>
98 <div class="section" id="reference-implementation">
99 <h1><a class="toc-backref" href="#id10" name="reference-implementation">Reference Implementation</a></h1>
100 <p>not yet ...</p>
101 </div>
102 <div class="section" id="references">
103 <h1><a class="toc-backref" href="#id11" name="references">References</a></h1>
104 <table class="footnote" frame="void" id="id4" rules="none">
105 <colgroup><col class="label" /><col /></colgroup>
106 <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
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>
109 </tbody>
110 </table>
111 </div>
112 <div class="section" id="copyright">
113 <h1><a class="toc-backref" href="#id12" name="copyright">Copyright</a></h1>
114 <p>This document has been placed in the public domain.</p>
115 </div>
116 </div>
117
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-02 22:52 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>
124 </body>
125 </html>

  ViewVC Help
Powered by ViewVC 1.1.20