/[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 - (hide annotations) (download) (as text)
Wed Jul 2 22:53:51 2003 UTC (9 years, 10 months ago) by g2boojum
Branch: MAIN
File MIME type: text/html 
New glep.
1 g2boojum 1.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>
126    
  ViewVC Help
Powered by ViewVC 1.1.13