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

Diff of /xml/htdocs/proj/en/glep/glep-0056.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 Revision 1.3
4 4
5<head> 5<head>
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" /> 7 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
8 <title>GLEP 56 -- USE flag descriptions in metadata</title> 8 <title>GLEP 56 -- USE flag descriptions in metadata</title>
9 <link rel="stylesheet" href="tools/glep.css" type="text/css" /> 9 <style type="text/css">
10
11/*
12:Author: David Goodger
13:Contact: goodger@users.sourceforge.net
14:date: $Date: 2008/07/10 22:14:40 $
15:version: $Revision: 1.3 $
16:copyright: This stylesheet has been placed in the public domain.
17
18Default cascading style sheet for the PEP HTML output of Docutils.
19*/
20
21.first {
22 margin-top: 0 }
23
24.last {
25 margin-bottom: 0 }
26
27.navigation {
28 width: 100% ;
29 background: #cc99ff ;
30 margin-top: 0px ;
31 margin-bottom: 0px }
32
33.navigation .navicon {
34 width: 150px ;
35 height: 35px }
36
37.navigation .textlinks {
38 padding-left: 1em ;
39 text-align: left }
40
41.navigation td, .navigation th {
42 padding-left: 0em ;
43 padding-right: 0em ;
44 vertical-align: middle }
45
46.rfc2822 {
47 margin-top: 0.5em ;
48 margin-left: 0.5em ;
49 margin-right: 0.5em ;
50 margin-bottom: 0em }
51
52.rfc2822 td {
53 text-align: left }
54
55.rfc2822 th.field-name {
56 text-align: right ;
57 font-family: sans-serif ;
58 padding-right: 0.5em ;
59 font-weight: bold ;
60 margin-bottom: 0em }
61
62a.toc-backref {
63 text-decoration: none ;
64 color: black }
65
66body {
67 margin: 0px ;
68 margin-bottom: 1em ;
69 padding: 0px }
70
71dd {
72 margin-bottom: 0.5em }
73
74div.section {
75 margin-left: 1em ;
76 margin-right: 1em ;
77 margin-bottom: 1.5em }
78
79div.section div.section {
80 margin-left: 0em ;
81 margin-right: 0em ;
82 margin-top: 1.5em }
83
84div.abstract {
85 margin: 2em 5em }
86
87div.abstract p.topic-title {
88 font-weight: bold ;
89 text-align: center }
90
91div.attention, div.caution, div.danger, div.error, div.hint,
92div.important, div.note, div.tip, div.warning {
93 margin: 2em ;
94 border: medium outset ;
95 padding: 1em }
96
97div.attention p.admonition-title, div.caution p.admonition-title,
98div.danger p.admonition-title, div.error p.admonition-title,
99div.warning p.admonition-title {
100 color: red ;
101 font-weight: bold ;
102 font-family: sans-serif }
103
104div.hint p.admonition-title, div.important p.admonition-title,
105div.note p.admonition-title, div.tip p.admonition-title {
106 font-weight: bold ;
107 font-family: sans-serif }
108
109div.figure {
110 margin-left: 2em }
111
112div.footer, div.header {
113 font-size: smaller }
114
115div.footer {
116 margin-left: 1em ;
117 margin-right: 1em }
118
119div.system-messages {
120 margin: 5em }
121
122div.system-messages h1 {
123 color: red }
124
125div.system-message {
126 border: medium outset ;
127 padding: 1em }
128
129div.system-message p.system-message-title {
130 color: red ;
131 font-weight: bold }
132
133div.topic {
134 margin: 2em }
135
136h1 {
137 font-family: sans-serif ;
138 font-size: large }
139
140h2 {
141 font-family: sans-serif ;
142 font-size: medium }
143
144h3 {
145 font-family: sans-serif ;
146 font-size: small }
147
148h4 {
149 font-family: sans-serif ;
150 font-style: italic ;
151 font-size: small }
152
153h5 {
154 font-family: sans-serif;
155 font-size: x-small }
156
157h6 {
158 font-family: sans-serif;
159 font-style: italic ;
160 font-size: x-small }
161
162.section hr {
163 width: 75% }
164
165ol.simple, ul.simple {
166 margin-bottom: 1em }
167
168ol.arabic {
169 list-style: decimal }
170
171ol.loweralpha {
172 list-style: lower-alpha }
173
174ol.upperalpha {
175 list-style: upper-alpha }
176
177ol.lowerroman {
178 list-style: lower-roman }
179
180ol.upperroman {
181 list-style: upper-roman }
182
183p.caption {
184 font-style: italic }
185
186p.credits {
187 font-style: italic ;
188 font-size: smaller }
189
190p.label {
191 white-space: nowrap }
192
193p.topic-title {
194 font-family: sans-serif ;
195 font-weight: bold }
196
197pre.line-block {
198 font-family: serif ;
199 font-size: 100% }
200
201pre.literal-block, pre.doctest-block {
202 margin-left: 2em ;
203 margin-right: 2em ;
204 background-color: #eeeeee }
205
206span.classifier {
207 font-family: sans-serif ;
208 font-style: oblique }
209
210span.classifier-delimiter {
211 font-family: sans-serif ;
212 font-weight: bold }
213
214span.interpreted {
215 font-family: sans-serif }
216
217span.option-argument {
218 font-style: italic }
219
220span.pre {
221 white-space: pre }
222
223span.problematic {
224 color: red }
225
226table {
227 margin-top: 0.5em ;
228 margin-bottom: 0.5em }
229
230td, th {
231 padding-left: 0.5em ;
232 padding-right: 0.5em ;
233 vertical-align: top }
234
235td.num {
236 text-align: right }
237
238th.field-name {
239 font-weight: bold ;
240 text-align: left ;
241 white-space: nowrap }
242
243h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
244 font-size: 100% }
245
246tt {
247 background-color: #eeeeee }
248
249ul.auto-toc {
250 list-style-type: none }
251
252</style>
10</head> 253</head>
11<body bgcolor="white"> 254<body bgcolor="white">
12<table class="navigation" cellpadding="0" cellspacing="0" 255<table class="navigation" cellpadding="0" cellspacing="0"
13 width="100%" border="0"> 256 width="100%" border="0">
14<tr><td class="navicon" width="150" height="35"> 257<tr><td class="navicon" width="150" height="35">
26<tbody valign="top"> 269<tbody valign="top">
27<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">56</td> 270<tr class="field"><th class="field-name">GLEP:</th><td class="field-body">56</td>
28</tr> 271</tr>
29<tr class="field"><th class="field-name">Title:</th><td class="field-body">USE flag descriptions in metadata</td> 272<tr class="field"><th class="field-name">Title:</th><td class="field-body">USE flag descriptions in metadata</td>
30</tr> 273</tr>
31<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</td> 274<tr class="field"><th class="field-name">Version:</th><td class="field-body">1.3</td>
32</tr> 275</tr>
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-0056.txt?cvsroot=gentoo">2008/07/10 18:15:05</a></td> 276<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-0056.txt?cvsroot=gentoo">2008/07/10 22:13:45</a></td>
34</tr> 277</tr>
35<tr class="field"><th class="field-name">Author:</th><td class="field-body">Doug Goldstein &lt;cardoe&#32;&#97;t&#32;gentoo.org&gt;</td> 278<tr class="field"><th class="field-name">Author:</th><td class="field-body">Doug Goldstein &lt;cardoe&#32;&#97;t&#32;gentoo.org&gt;</td>
36</tr> 279</tr>
37<tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> 280<tr class="field"><th class="field-name">Status:</th><td class="field-body">Accepted</td>
38</tr> 281</tr>
39<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> 282<tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
40</tr> 283</tr>
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> 284<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>
42</tr> 285</tr>
43<tr class="field"><th class="field-name">Created:</th><td class="field-body">03-Jun-2008</td> 286<tr class="field"><th class="field-name">Created:</th><td class="field-body">03-Jun-2008</td>
44</tr> 287</tr>
45<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">13-Jun-2008</td> 288<tr class="field"><th class="field-name">Post-History:</th><td class="field-body">05-June-2008, 13-Jun-2008</td>
46</tr> 289</tr>
47</tbody> 290</tbody>
48</table> 291</table>
49<hr /> 292<hr />
50<div class="contents topic"> 293<div class="contents topic">
51<p class="topic-title first"><a id="contents" name="contents">Contents</a></p> 294<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
52<ul class="simple"> 295<ul class="simple">
53<li><a class="reference" href="#abstract" id="id11" name="id11">Abstract</a></li> 296<li><a class="reference" href="#abstract" id="id12" name="id12">Abstract</a></li>
54<li><a class="reference" href="#motivation" id="id12" name="id12">Motivation</a></li> 297<li><a class="reference" href="#motivation" id="id13" name="id13">Motivation</a></li>
55<li><a class="reference" href="#specification" id="id13" name="id13">Specification</a></li> 298<li><a class="reference" href="#specification" id="id14" name="id14">Specification</a></li>
56<li><a class="reference" href="#credits" id="id14" name="id14">Credits</a></li> 299<li><a class="reference" href="#credits" id="id15" name="id15">Credits</a></li>
57<li><a class="reference" href="#references" id="id15" name="id15">References</a></li> 300<li><a class="reference" href="#references" id="id16" name="id16">References</a></li>
58<li><a class="reference" href="#backwards-compatibility" id="id16" name="id16">Backwards Compatibility</a></li> 301<li><a class="reference" href="#backwards-compatibility" id="id17" name="id17">Backwards Compatibility</a></li>
59<li><a class="reference" href="#copyright" id="id17" name="id17">Copyright</a></li> 302<li><a class="reference" href="#copyright" id="id18" name="id18">Copyright</a></li>
60</ul> 303</ul>
61</div> 304</div>
62<div class="section"> 305<div class="section">
63<h1><a class="toc-backref" href="#id11" id="abstract" name="abstract">Abstract</a></h1> 306<h1><a class="toc-backref" href="#id12" id="abstract" name="abstract">Abstract</a></h1>
64<p>This GLEP proposes to add per-package USE flag descriptions to each package's 307<p>This GLEP proposes to add per-package USE flag descriptions to each package's
65metadata.</p> 308metadata.</p>
66</div> 309</div>
67<div class="section"> 310<div class="section">
68<h1><a class="toc-backref" href="#id12" id="motivation" name="motivation">Motivation</a></h1> 311<h1><a class="toc-backref" href="#id13" id="motivation" name="motivation">Motivation</a></h1>
69<p>Gives Gentoo users the ability to better identify how USE flags affect their 312<p>Gives Gentoo users the ability to better identify how USE flags affect their
70installations of a given package. For example, many global USE flags have very 313installations of a given package. For example, many global USE flags have very
71generic descriptions but no specifics on how it affects a certain package. 314generic descriptions but no specifics on how it affects a certain package.
72Specifically speaking, an example would be net-print/cups and the 'jpeg' USE 315Specifically speaking, an example would be net-print/cups and the 'jpeg' USE
73flag. Does this flag mean you won't be able to print jpeg files? You can print 316flag. Does this flag mean you won't be able to print jpeg files? You can print
78and <a class="footnote-reference" href="#motivators4" id="id4" name="id4">[9]</a></li> 321and <a class="footnote-reference" href="#motivators4" id="id4" name="id4">[9]</a></li>
79</ul> 322</ul>
80</blockquote> 323</blockquote>
81</div> 324</div>
82<div class="section"> 325<div class="section">
83<h1><a class="toc-backref" href="#id13" id="specification" name="specification">Specification</a></h1> 326<h1><a class="toc-backref" href="#id14" id="specification" name="specification">Specification</a></h1>
84<p>This GLEP proposes the addition of <tt class="docutils literal"><span class="pre">&lt;use&gt;</span></tt> XML tag that is only allowed to 327<p>This GLEP proposes the addition of <tt class="docutils literal"><span class="pre">&lt;use&gt;</span></tt> XML tag that is only allowed to
85appear inside of a <tt class="docutils literal"><span class="pre">&lt;pkgmetadata&gt;</span></tt> XML tag.</p> 328appear inside of a <tt class="docutils literal"><span class="pre">&lt;pkgmetadata&gt;</span></tt> XML tag.</p>
86<blockquote> 329<blockquote>
87<ul> 330<ul>
88<li><p class="first">Inside the <tt class="docutils literal"><span class="pre">&lt;use&gt;</span></tt> XML tag, the <tt class="docutils literal"><span class="pre">&lt;flag&gt;</span></tt> XML tag is allowed to appear 331<li><p class="first">Inside the <tt class="docutils literal"><span class="pre">&lt;use&gt;</span></tt> XML tag, the <tt class="docutils literal"><span class="pre">&lt;flag&gt;</span></tt> XML tag is allowed to appear
107</ul> 350</ul>
108</blockquote> 351</blockquote>
109</li> 352</li>
110<li><p class="first">Each <tt class="docutils literal"><span class="pre">&lt;flag&gt;</span></tt> XML tag allows 0 or more nested <tt class="docutils literal"><span class="pre">&lt;pkg&gt;</span></tt> XML tags whose 353<li><p class="first">Each <tt class="docutils literal"><span class="pre">&lt;flag&gt;</span></tt> XML tag allows 0 or more nested <tt class="docutils literal"><span class="pre">&lt;pkg&gt;</span></tt> XML tags whose
111character data is a valid CP or CPV as defined by the 354character data is a valid CP or CPV as defined by the
112<cite>Gentoo Development Guide - Ebuild File Format</cite> <a class="footnote-reference" href="#devmanual" id="id6" name="id6">[5]</a>.</p> 355<cite>Gentoo Development Manual - Ebuild File Format</cite> <a class="footnote-reference" href="#devmanual" id="id6" name="id6">[5]</a>.</p>
113</li> 356</li>
114<li><p class="first">Each <tt class="docutils literal"><span class="pre">&lt;flag&gt;</span></tt> XML tag allows 0 or more nested <tt class="docutils literal"><span class="pre">&lt;cat&gt;</span></tt> XML tags whose 357<li><p class="first">Each <tt class="docutils literal"><span class="pre">&lt;flag&gt;</span></tt> XML tag allows 0 or more nested <tt class="docutils literal"><span class="pre">&lt;cat&gt;</span></tt> XML tags whose
115character data is a valid category.</p> 358character data is a valid category.</p>
116</li> 359</li>
117<li><p class="first">The <tt class="docutils literal"><span class="pre">&lt;use&gt;</span></tt> XML tag may appear multiple times inside of the 360<li><p class="first">The <tt class="docutils literal"><span class="pre">&lt;use&gt;</span></tt> XML tag may appear multiple times inside of the
122<cite>Gentoo Developer Handbook</cite> <a class="footnote-reference" href="#devhandbook" id="id7" name="id7">[4]</a>.</li> 365<cite>Gentoo Developer Handbook</cite> <a class="footnote-reference" href="#devhandbook" id="id7" name="id7">[4]</a>.</li>
123</ul> 366</ul>
124</li> 367</li>
125</ul> 368</ul>
126</blockquote> 369</blockquote>
127<p>Documentation for the Developer Manual and the metadata.dtd can be found in 370<p>Documentation for the <cite>Gentoo Developer Handbook</cite> <a class="footnote-reference" href="#devhandbook" id="id8" name="id8">[4]</a> and the
128Gentoo's Bugzilla <a class="footnote-reference" href="#use-flag-metadata-bug" id="id8" name="id8">[1]</a> bug #199788.</p> 371metadata.dtd can be found in Gentoo's Bugzilla <a class="footnote-reference" href="#use-flag-metadata-bug" id="id9" name="id9">[1]</a>
372bug #199788.</p>
129<p>The following are two concrete examples in tree, <a class="footnote-reference" href="#use-flag-metadata-example1" id="id9" name="id9">[2]</a> 373<p>The following are two concrete examples in tree, <a class="footnote-reference" href="#use-flag-metadata-example1" id="id10" name="id10">[2]</a>
130and <a class="footnote-reference" href="#use-flag-metadata-example2" id="id10" name="id10">[3]</a>.</p> 374and <a class="footnote-reference" href="#use-flag-metadata-example2" id="id11" name="id11">[3]</a>.</p>
131<p>And the following is an embedded example and not from a real package:</p> 375<p>And the following is an embedded example and not from a real package:</p>
132<pre class="literal-block"> 376<pre class="literal-block">
133&lt;use&gt; 377&lt;use&gt;
134 &lt;flag name='acpi'&gt;Enables HAL to attempt to read from 378 &lt;flag name='acpi'&gt;Enables HAL to attempt to read from
135 /proc/acpi/event, if unavailable, HAL will read events from 379 /proc/acpi/event, if unavailable, HAL will read events from
142 dictionaries found in &lt;cat&gt;app-dict&lt;/cat&gt;&lt;/flag&gt; 386 dictionaries found in &lt;cat&gt;app-dict&lt;/cat&gt;&lt;/flag&gt;
143&lt;/use&gt; 387&lt;/use&gt;
144</pre> 388</pre>
145</div> 389</div>
146<div class="section"> 390<div class="section">
147<h1><a class="toc-backref" href="#id14" id="credits" name="credits">Credits</a></h1> 391<h1><a class="toc-backref" href="#id15" id="credits" name="credits">Credits</a></h1>
148<p>Thanks to the following persons for their input on or related to this GLEP 392<p>Thanks to the following persons for their input on or related to this GLEP
149(even though they might not have known it): 393(even though they might not have known it):
150Diego Pettenò (flameeyes), Alec Warner (antarus), Joshua Nichols (nichoj), 394Diego Pettenò (flameeyes), Alec Warner (antarus), Joshua Nichols (nichoj),
151Steve Dibb (beandog), and Tiziano Müller (dev-zero)</p> 395Steve Dibb (beandog), and Tiziano Müller (dev-zero)</p>
152</div> 396</div>
153<div class="section"> 397<div class="section">
154<h1><a class="toc-backref" href="#id15" id="references" name="references">References</a></h1> 398<h1><a class="toc-backref" href="#id16" id="references" name="references">References</a></h1>
155<table class="docutils footnote" frame="void" id="use-flag-metadata-bug" rules="none"> 399<table class="docutils footnote" frame="void" id="use-flag-metadata-bug" rules="none">
156<colgroup><col class="label" /><col /></colgroup> 400<colgroup><col class="label" /><col /></colgroup>
157<tbody valign="top"> 401<tbody valign="top">
158<tr><td class="label"><a class="fn-backref" href="#id8" name="use-flag-metadata-bug">[1]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=199788">http://bugs.gentoo.org/show_bug.cgi?id=199788</a></td></tr> 402<tr><td class="label"><a class="fn-backref" href="#id9" name="use-flag-metadata-bug">[1]</a></td><td><a class="reference" href="http://bugs.gentoo.org/show_bug.cgi?id=199788">http://bugs.gentoo.org/show_bug.cgi?id=199788</a></td></tr>
159</tbody> 403</tbody>
160</table> 404</table>
161<table class="docutils footnote" frame="void" id="use-flag-metadata-example1" rules="none"> 405<table class="docutils footnote" frame="void" id="use-flag-metadata-example1" rules="none">
162<colgroup><col class="label" /><col /></colgroup> 406<colgroup><col class="label" /><col /></colgroup>
163<tbody valign="top"> 407<tbody valign="top">
164<tr><td class="label"><a class="fn-backref" href="#id9" name="use-flag-metadata-example1">[2]</a></td><td><a class="reference" href="http://sources.gentoo.org/viewcvs.py/gentoo-x86/sys-apps/hal/metadata.xml?view=markup">http://sources.gentoo.org/viewcvs.py/gentoo-x86/sys-apps/hal/metadata.xml?view=markup</a></td></tr> 408<tr><td class="label"><a class="fn-backref" href="#id10" name="use-flag-metadata-example1">[2]</a></td><td><a class="reference" href="http://sources.gentoo.org/viewcvs.py/gentoo-x86/sys-apps/hal/metadata.xml?view=markup">http://sources.gentoo.org/viewcvs.py/gentoo-x86/sys-apps/hal/metadata.xml?view=markup</a></td></tr>
165</tbody> 409</tbody>
166</table> 410</table>
167<table class="docutils footnote" frame="void" id="use-flag-metadata-example2" rules="none"> 411<table class="docutils footnote" frame="void" id="use-flag-metadata-example2" rules="none">
168<colgroup><col class="label" /><col /></colgroup> 412<colgroup><col class="label" /><col /></colgroup>
169<tbody valign="top"> 413<tbody valign="top">
170<tr><td class="label"><a class="fn-backref" href="#id10" name="use-flag-metadata-example2">[3]</a></td><td><a class="reference" href="http://sources.gentoo.org/viewcvs.py/gentoo-x86/media-tv/mythtv/metadata.xml?view=markup">http://sources.gentoo.org/viewcvs.py/gentoo-x86/media-tv/mythtv/metadata.xml?view=markup</a></td></tr> 414<tr><td class="label"><a class="fn-backref" href="#id11" name="use-flag-metadata-example2">[3]</a></td><td><a class="reference" href="http://sources.gentoo.org/viewcvs.py/gentoo-x86/media-tv/mythtv/metadata.xml?view=markup">http://sources.gentoo.org/viewcvs.py/gentoo-x86/media-tv/mythtv/metadata.xml?view=markup</a></td></tr>
171</tbody> 415</tbody>
172</table> 416</table>
173<table class="docutils footnote" frame="void" id="devhandbook" rules="none"> 417<table class="docutils footnote" frame="void" id="devhandbook" rules="none">
174<colgroup><col class="label" /><col /></colgroup> 418<colgroup><col class="label" /><col /></colgroup>
175<tbody valign="top"> 419<tbody valign="top">
176<tr><td class="label"><a name="devhandbook">[4]</a></td><td><em>(<a class="fn-backref" href="#id5">1</a>, <a class="fn-backref" href="#id7">2</a>)</em> <a class="reference" href="http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&amp;chap=4">http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&amp;chap=4</a></td></tr> 420<tr><td class="label"><a name="devhandbook">[4]</a></td><td><em>(<a class="fn-backref" href="#id5">1</a>, <a class="fn-backref" href="#id7">2</a>, <a class="fn-backref" href="#id8">3</a>)</em> <a class="reference" href="http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&amp;chap=4">http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&amp;chap=4</a></td></tr>
177</tbody> 421</tbody>
178</table> 422</table>
179<table class="docutils footnote" frame="void" id="devmanual" rules="none"> 423<table class="docutils footnote" frame="void" id="devmanual" rules="none">
180<colgroup><col class="label" /><col /></colgroup> 424<colgroup><col class="label" /><col /></colgroup>
181<tbody valign="top"> 425<tbody valign="top">
206<tr><td class="label"><a class="fn-backref" href="#id4" name="motivators4">[9]</a></td><td><a class="reference" href="http://technicalpickles.com/posts/pidgin-idle-time">http://technicalpickles.com/posts/pidgin-idle-time</a></td></tr> 450<tr><td class="label"><a class="fn-backref" href="#id4" name="motivators4">[9]</a></td><td><a class="reference" href="http://technicalpickles.com/posts/pidgin-idle-time">http://technicalpickles.com/posts/pidgin-idle-time</a></td></tr>
207</tbody> 451</tbody>
208</table> 452</table>
209</div> 453</div>
210<div class="section"> 454<div class="section">
211<h1><a class="toc-backref" href="#id16" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1> 455<h1><a class="toc-backref" href="#id17" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1>
212<p>No changes are necessary to existing <tt class="docutils literal"><span class="pre">metadata.xml</span></tt> files. Information in 456<p>No changes are necessary to existing <tt class="docutils literal"><span class="pre">metadata.xml</span></tt> files. Information in
213the new tags is not mandatory. Tools that currently read <tt class="docutils literal"><span class="pre">metadata.xml</span></tt> 457the new tags is not mandatory. Tools that currently read <tt class="docutils literal"><span class="pre">metadata.xml</span></tt>
214files may break if written poorly, while well written tools should just ignore 458files may break if written poorly, while well written tools should just ignore
215the additional elements. Tools which are capable of handling the new tags 459the additional elements. Tools which are capable of handling the new tags
216should prefer their data over <tt class="docutils literal"><span class="pre">use.desc</span></tt> and <tt class="docutils literal"><span class="pre">use.local.desc</span></tt>.</p> 460should prefer their data over <tt class="docutils literal"><span class="pre">use.desc</span></tt> and <tt class="docutils literal"><span class="pre">use.local.desc</span></tt>.</p>
224non-CVS trees. At this time, QA tools will need to be updated to verify the 468non-CVS trees. At this time, QA tools will need to be updated to verify the
225contents of <tt class="docutils literal"><span class="pre">metadata.xml</span></tt> containing the necessary tags which would appear 469contents of <tt class="docutils literal"><span class="pre">metadata.xml</span></tt> containing the necessary tags which would appear
226in <tt class="docutils literal"><span class="pre">use.local.desc</span></tt>.</p> 470in <tt class="docutils literal"><span class="pre">use.local.desc</span></tt>.</p>
227</div> 471</div>
228<div class="section"> 472<div class="section">
229<h1><a class="toc-backref" href="#id17" id="copyright" name="copyright">Copyright</a></h1> 473<h1><a class="toc-backref" href="#id18" id="copyright" name="copyright">Copyright</a></h1>
230<p>This document is placed into the public domain.</p> 474<p>This document is placed into the public domain.</p>
231<!-- vim: set ft=glep tw=72 : --> 475<!-- vim: set ft=glep tw=72 : -->
232</div> 476</div>
233 477
234</div> 478</div>
235<div class="footer"> 479<div class="footer">
236<hr class="footer" /> 480<hr class="footer" />
237<a class="reference" href="glep-0056.txt">View document source</a>. 481<a class="reference" href="glep-0056.txt">View document source</a>.
238Generated on: 2008-07-10 18:23 UTC. 482Generated on: 2008-07-10 22:14 UTC.
239Generated 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. 483Generated 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.
240 484
241</div> 485</div>
242</body> 486</body>
243</html> 487</html>

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.3

  ViewVC Help
Powered by ViewVC 1.1.20