… | |
… | |
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 | <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.5: http://docutils.sourceforge.net/" /> |
7 | <meta name="generator" content="Docutils 0.6: http://docutils.sourceforge.net/" /> |
8 | <title>GLEP 60 -- Manifest2 filetypes</title> |
8 | <title>GLEP 60 -- Manifest2 filetypes</title> |
9 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /></head> |
9 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /></head> |
10 | <body bgcolor="white"> |
10 | <body bgcolor="white"> |
11 | <table class="navigation" cellpadding="0" cellspacing="0" |
11 | <table class="navigation" cellpadding="0" cellspacing="0" |
12 | width="100%" border="0"> |
12 | width="100%" border="0"> |
… | |
… | |
25 | <tbody valign="top"> |
25 | <tbody valign="top"> |
26 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">60</td> |
26 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">60</td> |
27 | </tr> |
27 | </tr> |
28 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Manifest2 filetypes</td> |
28 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Manifest2 filetypes</td> |
29 | </tr> |
29 | </tr> |
30 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.3</td> |
30 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.8</td> |
31 | </tr> |
31 | </tr> |
32 | <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0060.txt?cvsroot=gentoo">2008/10/28 07:46:51</a></td> |
32 | <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference external" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0060.txt?cvsroot=gentoo">2010/01/31 07:56:58</a></td> |
33 | </tr> |
33 | </tr> |
34 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Robin Hugh Johnson <robbat2 at gentoo.org></td> |
34 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Robin Hugh Johnson <robbat2 at gentoo.org></td> |
35 | </tr> |
35 | </tr> |
36 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> |
36 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> |
37 | </tr> |
37 | </tr> |
… | |
… | |
41 | </tr> |
41 | </tr> |
42 | <tr class="field"><th class="field-name">Requires:</th><td class="field-body"><a class="reference external" href="http://www.gentoo.org/proj/en/glepglep-0044.html">44</a></td> |
42 | <tr class="field"><th class="field-name">Requires:</th><td class="field-body"><a class="reference external" href="http://www.gentoo.org/proj/en/glepglep-0044.html">44</a></td> |
43 | </tr> |
43 | </tr> |
44 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">November 2007</td> |
44 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">November 2007</td> |
45 | </tr> |
45 | </tr> |
46 | <tr class="field"><th class="field-name">Updated:</th><td class="field-body">June 2008, July 2008, October 2008</td> |
46 | <tr class="field"><th class="field-name">Updated:</th><td class="field-body">June 2008, July 2008, October 2008, January 2010</td> |
47 | </tr> |
47 | </tr> |
48 | <tr class="field"><th class="field-name">Updates:</th><td class="field-body">44</td> |
48 | <tr class="field"><th class="field-name">Updates:</th><td class="field-body">44</td> |
49 | </tr> |
49 | </tr> |
50 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body"></td> |
50 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">December 2009, January 2010</td> |
51 | </tr> |
51 | </tr> |
52 | </tbody> |
52 | </tbody> |
53 | </table> |
53 | </table> |
54 | <hr /> |
54 | <hr /> |
55 | <div class="contents topic" id="contents"> |
55 | <div class="contents topic" id="contents"> |
… | |
… | |
75 | <li><a class="reference internal" href="#id3" id="id19">MISC</a></li> |
75 | <li><a class="reference internal" href="#id3" id="id19">MISC</a></li> |
76 | <li><a class="reference internal" href="#manifest-new" id="id20">MANIFEST (new)</a></li> |
76 | <li><a class="reference internal" href="#manifest-new" id="id20">MANIFEST (new)</a></li> |
77 | <li><a class="reference internal" href="#eclass-new" id="id21">ECLASS (new)</a></li> |
77 | <li><a class="reference internal" href="#eclass-new" id="id21">ECLASS (new)</a></li> |
78 | <li><a class="reference internal" href="#data-new" id="id22">DATA (new)</a></li> |
78 | <li><a class="reference internal" href="#data-new" id="id22">DATA (new)</a></li> |
79 | <li><a class="reference internal" href="#exec-new" id="id23">EXEC (new)</a></li> |
79 | <li><a class="reference internal" href="#exec-new" id="id23">EXEC (new)</a></li> |
80 | <li><a class="reference internal" href="#unknown-new" id="id24">UNKNOWN (new)</a></li> |
80 | <li><a class="reference internal" href="#other-new" id="id24">OTHER (new)</a></li> |
81 | </ul> |
81 | </ul> |
82 | </li> |
82 | </li> |
83 | <li><a class="reference internal" href="#on-bloat" id="id25">On Bloat</a></li> |
83 | <li><a class="reference internal" href="#on-bloat" id="id25">On Bloat</a></li> |
84 | <li><a class="reference internal" href="#chosing-a-filetype" id="id26">Chosing a filetype</a></li> |
84 | <li><a class="reference internal" href="#chosing-a-filetype" id="id26">Chosing a filetype</a></li> |
85 | </ul> |
85 | </ul> |
… | |
… | |
99 | <h1><a class="toc-backref" href="#id5">Motivation</a></h1> |
99 | <h1><a class="toc-backref" href="#id5">Motivation</a></h1> |
100 | <p>[#GLEP44] was not entirely clear on the usage of filetype specifiers. |
100 | <p>[#GLEP44] was not entirely clear on the usage of filetype specifiers. |
101 | This document serves to provide some of the internal logic used by |
101 | This document serves to provide some of the internal logic used by |
102 | Portage at the point of writing, as well as adding new types to cover |
102 | Portage at the point of writing, as well as adding new types to cover |
103 | the rest of the tree, for the purposes of tree-signing coverage.</p> |
103 | the rest of the tree, for the purposes of tree-signing coverage.</p> |
|
|
104 | <p>This GLEP is not mandatory for the tree-signing specification, but |
|
|
105 | instead aims to clarify the usage of the Manifest2 filetype specifiers, |
|
|
106 | and note which types signify files that are allowed to be missing from |
|
|
107 | the tree (e.g. a user excluding a package or category).</p> |
104 | </div> |
108 | </div> |
105 | <div class="section" id="specification"> |
109 | <div class="section" id="specification"> |
106 | <h1><a class="toc-backref" href="#id6">Specification</a></h1> |
110 | <h1><a class="toc-backref" href="#id6">Specification</a></h1> |
107 | <div class="section" id="general"> |
111 | <div class="section" id="general"> |
108 | <h2><a class="toc-backref" href="#id7">General</a></h2> |
112 | <h2><a class="toc-backref" href="#id7">General</a></h2> |
… | |
… | |
111 | unless stated otherwise in the following sections. The Manifest file |
115 | unless stated otherwise in the following sections. The Manifest file |
112 | must not contain an entry for itself.</p> |
116 | must not contain an entry for itself.</p> |
113 | </div> |
117 | </div> |
114 | <div class="section" id="excluded-files"> |
118 | <div class="section" id="excluded-files"> |
115 | <h2><a class="toc-backref" href="#id8">Excluded files</a></h2> |
119 | <h2><a class="toc-backref" href="#id8">Excluded files</a></h2> |
116 | <p>When generating or validating a Manifest, or commiting to a version |
120 | <p>When generating or validating a Manifest, or committing to a version |
117 | control system, the package manager should endeavour to ignore files |
121 | control system, the package manager should endeavour to ignore files |
118 | created by a version control system, backup files from text editors. A |
122 | created by a version control system, backup files from text editors. A |
119 | non-exhaustive list is suggested here: <tt class="docutils literal"><span class="pre">CVS/</span></tt>, <tt class="docutils literal"><span class="pre">.svn/</span></tt>, <tt class="docutils literal"><span class="pre">.bzr/</span></tt>, |
123 | non-exhaustive list is suggested here: <tt class="docutils literal">CVS/</tt>, <tt class="docutils literal">.svn/</tt>, <tt class="docutils literal">.bzr/</tt>, |
120 | <tt class="docutils literal"><span class="pre">.git/</span></tt>, <tt class="docutils literal"><span class="pre">.hg/</span></tt>, <tt class="docutils literal"><span class="pre">.#*</span></tt>, <tt class="docutils literal"><span class="pre">*.rej</span></tt>, <tt class="docutils literal"><span class="pre">*.orig</span></tt>, <tt class="docutils literal"><span class="pre">*.bak</span></tt>, <tt class="docutils literal"><span class="pre">*~</span></tt>.</p> |
124 | <tt class="docutils literal">.git/</tt>, <tt class="docutils literal">.hg/</tt>, <tt class="docutils literal">.#*</tt>, <tt class="docutils literal">*.rej</tt>, <tt class="docutils literal">*.orig</tt>, <tt class="docutils literal">*.bak</tt>, <tt class="docutils literal">*~</tt>.</p> |
121 | <p>Additionally, for a transitional Manifest1->Manifest2 system, old-style |
125 | <p>Additionally, for a transitional Manifest1->Manifest2 system, old-style |
122 | digest files located in a 'files/' directory, may be excluded from |
126 | digest files located in a 'files/' directory, may be excluded from |
123 | Manifest2 generation, or included with a type of MISC.</p> |
127 | Manifest2 generation, or included with a type of MISC.</p> |
124 | <p>Under strict security conditions, the exclusion list may be ignored |
128 | <p>Under strict security conditions, the exclusion list may be ignored |
125 | during validation if the existence of a file would be considered a |
129 | during validation if the existence of a file would be considered a |
… | |
… | |
190 | <div class="section" id="crit-new-abstract"> |
194 | <div class="section" id="crit-new-abstract"> |
191 | <h3><a class="toc-backref" href="#id16">_CRIT (new, abstract)</a></h3> |
195 | <h3><a class="toc-backref" href="#id16">_CRIT (new, abstract)</a></h3> |
192 | <ul class="simple"> |
196 | <ul class="simple"> |
193 | <li>_CRIT is based off the _INFO type.</li> |
197 | <li>_CRIT is based off the _INFO type.</li> |
194 | <li>The modification or absence of a file listed as a _CRIT-derived type |
198 | <li>The modification or absence of a file listed as a _CRIT-derived type |
195 | must be treated as an error.</li> |
199 | MUST be treated as an error.</li> |
196 | </ul> |
200 | </ul> |
197 | </div> |
201 | </div> |
198 | <div class="section" id="id1"> |
202 | <div class="section" id="id1"> |
199 | <h3><a class="toc-backref" href="#id17">EBUILD</a></h3> |
203 | <h3><a class="toc-backref" href="#id17">EBUILD</a></h3> |
200 | <ul class="simple"> |
204 | <ul class="simple"> |
… | |
… | |
220 | <h3><a class="toc-backref" href="#id20">MANIFEST (new)</a></h3> |
224 | <h3><a class="toc-backref" href="#id20">MANIFEST (new)</a></h3> |
221 | <ul class="simple"> |
225 | <ul class="simple"> |
222 | <li>The MANIFEST type is explicitly to cover all nested Manifest files.</li> |
226 | <li>The MANIFEST type is explicitly to cover all nested Manifest files.</li> |
223 | <li>During validation, this serves as an indicator that the package |
227 | <li>During validation, this serves as an indicator that the package |
224 | manager may need to check subtree Manifest file.</li> |
228 | manager may need to check subtree Manifest file.</li> |
225 | <li>A missing MANIFEST file may be treated as a minor (eg excluding an |
229 | <li>A missing MANIFEST file may be treated as a minor (e.g. excluding an |
226 | entire category) or critical validation failure.</li> |
230 | entire category) or critical validation failure.</li> |
227 | <li>The failure should be considered as critical only if files that would |
231 | <li>The failure should be considered as critical only if files that would |
228 | be directly covered by this Manifest are missing. Deletion of a |
232 | be directly covered by this Manifest are missing. Deletion of a |
229 | category-level Manifest while preserving the packages is forbidden. |
233 | category-level Manifest while preserving the packages is forbidden. |
230 | Deletion of an entire category is not.</li> |
234 | Deletion of an entire category is not.</li> |
… | |
… | |
233 | <div class="section" id="eclass-new"> |
237 | <div class="section" id="eclass-new"> |
234 | <h3><a class="toc-backref" href="#id21">ECLASS (new)</a></h3> |
238 | <h3><a class="toc-backref" href="#id21">ECLASS (new)</a></h3> |
235 | <ul class="simple"> |
239 | <ul class="simple"> |
236 | <li>uses _CRIT.</li> |
240 | <li>uses _CRIT.</li> |
237 | <li>This type shall be used for all eclasses only.</li> |
241 | <li>This type shall be used for all eclasses only.</li> |
238 | <li>TODO: What about patches etc under eclasses/? Probably EXEC?</li> |
|
|
239 | </ul> |
242 | </ul> |
240 | </div> |
243 | </div> |
241 | <div class="section" id="data-new"> |
244 | <div class="section" id="data-new"> |
242 | <h3><a class="toc-backref" href="#id22">DATA (new)</a></h3> |
245 | <h3><a class="toc-backref" href="#id22">DATA (new)</a></h3> |
243 | <ul class="simple"> |
246 | <ul class="simple"> |
… | |
… | |
249 | <div class="section" id="exec-new"> |
252 | <div class="section" id="exec-new"> |
250 | <h3><a class="toc-backref" href="#id23">EXEC (new)</a></h3> |
253 | <h3><a class="toc-backref" href="#id23">EXEC (new)</a></h3> |
251 | <ul class="simple"> |
254 | <ul class="simple"> |
252 | <li>uses _CRIT.</li> |
255 | <li>uses _CRIT.</li> |
253 | <li>If the file gets sourced, executed, or causes a change (patches) in |
256 | <li>If the file gets sourced, executed, or causes a change (patches) in |
254 | how something is sourced or execututed, it belongs in the EXEC |
257 | how something is sourced or executed, it belongs in the EXEC |
255 | filetype.</li> |
258 | filetype.</li> |
256 | <li>This filetype should be used for the scripts directories of a |
259 | <li>This filetype should be used for the scripts directories of a |
257 | repository for important files.</li> |
260 | repository for important files.</li> |
|
|
261 | <li>This filetype is not limited to being used in the files/ |
|
|
262 | subdirectory.</li> |
258 | </ul> |
263 | </ul> |
259 | </div> |
264 | </div> |
260 | <div class="section" id="unknown-new"> |
265 | <div class="section" id="other-new"> |
261 | <h3><a class="toc-backref" href="#id24">UNKNOWN (new)</a></h3> |
266 | <h3><a class="toc-backref" href="#id24">OTHER (new)</a></h3> |
262 | <ul class="simple"> |
267 | <ul class="simple"> |
263 | <li>uses _CRIT.</li> |
268 | <li>uses _CRIT.</li> |
264 | <li>All other files that are not covered by another type should be |
269 | <li>All other files that are not covered by another type should be |
265 | considered as 'UNKNOWN'.</li> |
270 | considered as 'OTHER'.</li> |
|
|
271 | <li>Any further new filetypes should be introduced to subtract files |
|
|
272 | from the 'OTHER' set.</li> |
|
|
273 | <li>If a package manager runs into a unknown Manifest2 type, it should |
|
|
274 | be treated as 'OTHER'.</li> |
266 | </ul> |
275 | </ul> |
267 | </div> |
276 | </div> |
268 | </div> |
277 | </div> |
269 | <div class="section" id="on-bloat"> |
278 | <div class="section" id="on-bloat"> |
270 | <h2><a class="toc-backref" href="#id25">On Bloat</a></h2> |
279 | <h2><a class="toc-backref" href="#id25">On Bloat</a></h2> |
271 | <p>If repeated use of a common path prefix is considered a bloat problem, a |
280 | <p>If repeated use of a common path prefix is considered a bloat problem, a |
272 | Manifest file should be added inside the common directory, however this |
281 | Manifest file should be added inside the common directory, however this |
273 | should not be done blindly, as bloat by inodes is more significant for |
282 | should not be done blindly, as bloat by inodes is more significant for |
274 | the majority of use cases.</p> |
283 | the majority of use cases. See also [#GLEP58] on size reductions of |
|
|
284 | Manifests.</p> |
275 | </div> |
285 | </div> |
276 | <div class="section" id="chosing-a-filetype"> |
286 | <div class="section" id="chosing-a-filetype"> |
277 | <h2><a class="toc-backref" href="#id26">Chosing a filetype</a></h2> |
287 | <h2><a class="toc-backref" href="#id26">Chosing a filetype</a></h2> |
278 | <ol class="arabic"> |
288 | <ol class="arabic"> |
279 | <li><dl class="first docutils"> |
289 | <li><dl class="first docutils"> |
280 | <dt>matches Manifest</dt> |
290 | <dt>matches <tt class="docutils literal">Manifest</tt></dt> |
281 | <dd><p class="first last">=> MANIFEST, stop.</p> |
291 | <dd><p class="first last">=> MANIFEST, stop.</p> |
282 | </dd> |
292 | </dd> |
283 | </dl> |
293 | </dl> |
284 | </li> |
294 | </li> |
285 | <li><dl class="first docutils"> |
295 | <li><dl class="first docutils"> |
286 | <dt>matches <tt class="docutils literal"><span class="pre">*.ebuild</span></tt></dt> |
296 | <dt>matches <tt class="docutils literal">*.ebuild</tt></dt> |
287 | <dd><p class="first last">=> EBUILD, stop.</p> |
297 | <dd><p class="first last">=> EBUILD, stop.</p> |
288 | </dd> |
298 | </dd> |
289 | </dl> |
299 | </dl> |
290 | </li> |
300 | </li> |
291 | <li><dl class="first docutils"> |
301 | <li><dl class="first docutils"> |
292 | <dt>matches <tt class="docutils literal"><span class="pre">*.eclass</span></tt></dt> |
302 | <dt>matches <tt class="docutils literal">*.eclass</tt></dt> |
293 | <dd><p class="first last">=> ECLASS, stop.</p> |
303 | <dd><p class="first last">=> ECLASS, stop.</p> |
294 | </dd> |
304 | </dd> |
295 | </dl> |
305 | </dl> |
296 | </li> |
306 | </li> |
297 | <li><dl class="first docutils"> |
307 | <li><dl class="first docutils"> |
… | |
… | |
299 | <dd><p class="first last">=> DIST, stop.</p> |
309 | <dd><p class="first last">=> DIST, stop.</p> |
300 | </dd> |
310 | </dd> |
301 | </dl> |
311 | </dl> |
302 | </li> |
312 | </li> |
303 | <li><dl class="first docutils"> |
313 | <li><dl class="first docutils"> |
304 | <dt>matches <tt class="docutils literal"><span class="pre">files/*</span></tt></dt> |
314 | <dt>matches <tt class="docutils literal">files/*</tt></dt> |
305 | <dd><p class="first last">=> AUX, continue [see note].</p> |
315 | <dd><p class="first last">=> AUX, continue [see note].</p> |
306 | </dd> |
316 | </dd> |
307 | </dl> |
317 | </dl> |
308 | </li> |
318 | </li> |
309 | <li><dl class="first docutils"> |
319 | <li><dl class="first docutils"> |
310 | <dt>matches any of <tt class="docutils literal"><span class="pre">*.sh</span></tt>, <tt class="docutils literal"><span class="pre">*.bashrc</span></tt>, <tt class="docutils literal"><span class="pre">*.patch</span></tt>, ...</dt> |
320 | <dt>matches any of <tt class="docutils literal">*.sh</tt>, <tt class="docutils literal">*.bashrc</tt>, <tt class="docutils literal">*.patch</tt>, ...</dt> |
311 | <dd><p class="first last">=> EXEC, stop.</p> |
321 | <dd><p class="first last">=> EXEC, stop.</p> |
312 | </dd> |
322 | </dd> |
313 | </dl> |
323 | </dl> |
314 | </li> |
324 | </li> |
315 | <li><dl class="first docutils"> |
325 | <li><dl class="first docutils"> |
316 | <dt>matches any of <tt class="docutils literal"><span class="pre">metadata/cache/*</span></tt>, <tt class="docutils literal"><span class="pre">profiles/</span></tt>, <tt class="docutils literal"><span class="pre">package.*</span></tt>, <tt class="docutils literal"><span class="pre">use.mask*</span></tt>, ...</dt> |
326 | <dt>matches any of <tt class="docutils literal">metadata/cache/*</tt>, <tt class="docutils literal">profiles/</tt>, <tt class="docutils literal">package.*</tt>, <tt class="docutils literal">use.mask*</tt>, ...</dt> |
317 | <dd><p class="first last">=> DATA, stop.</p> |
327 | <dd><p class="first last">=> DATA, stop.</p> |
318 | </dd> |
328 | </dd> |
319 | </dl> |
329 | </dl> |
320 | </li> |
330 | </li> |
321 | <li><dl class="first docutils"> |
331 | <li><dl class="first docutils"> |
322 | <dt>matches any of <tt class="docutils literal"><span class="pre">ChangeLog</span></tt>, <tt class="docutils literal"><span class="pre">metadata.xml</span></tt>, <tt class="docutils literal"><span class="pre">*.desc</span></tt>, ...</dt> |
332 | <dt>matches any of <tt class="docutils literal">ChangeLog</tt>, <tt class="docutils literal">metadata.xml</tt>, <tt class="docutils literal">*.desc</tt>, ...</dt> |
323 | <dd><p class="first last">=> MISC, stop.</p> |
333 | <dd><p class="first last">=> MISC, stop.</p> |
324 | </dd> |
334 | </dd> |
325 | </dl> |
335 | </dl> |
326 | </li> |
336 | </li> |
327 | <li><dl class="first docutils"> |
337 | <li><dl class="first docutils"> |
328 | <dt>not matched by any other rule</dt> |
338 | <dt>not matched by any other rule</dt> |
329 | <dd><p class="first last">=> UNKNOWN, stop.</p> |
339 | <dd><p class="first last">=> OTHER, stop.</p> |
330 | </dd> |
340 | </dd> |
331 | </dl> |
341 | </dl> |
332 | </li> |
342 | </li> |
333 | </ol> |
343 | </ol> |
334 | <p>The logic behind 5, 6, 7 is ensuring that every item that by it's |
344 | <p>The logic behind 5, 6, 7 is ensuring that every item that by it's |
335 | presence or absense may be dangerous should always be treated strictly. |
345 | presence or absence may be dangerous should always be treated strictly. |
336 | (Consider epatch given a directory of patches <tt class="docutils literal"><span class="pre">${FILESDIR}/${PV}/</span></tt>, |
346 | (Consider epatch given a directory of patches <tt class="docutils literal"><span class="pre">${FILESDIR}/${PV}/</span></tt>, |
337 | where it blindly includes them, or alternatively, the package.mask file |
347 | where it blindly includes them, or alternatively, the package.mask file |
338 | or a profile being altered/missing).</p> |
348 | or a profile being altered/missing).</p> |
|
|
349 | <p>The above lists of file patterns are not intended to be exhaustive, |
|
|
350 | but merely demonstrative.</p> |
339 | <p>Note: The AUX entries should only be generated if we are generating a |
351 | <p>Note: The AUX entries should only be generated if we are generating a |
340 | compatible Manifest that supports older versions of Portage. They should |
352 | compatible Manifest that supports older versions of Portage. They should |
341 | be generated along with the new type.</p> |
353 | be generated along with the new type.</p> |
342 | </div> |
354 | </div> |
343 | </div> |
355 | </div> |
… | |
… | |
345 | <h1><a class="toc-backref" href="#id27">Backwards Compatibility</a></h1> |
357 | <h1><a class="toc-backref" href="#id27">Backwards Compatibility</a></h1> |
346 | <p>For generation of existing package Manifests, the AUX entries must |
358 | <p>For generation of existing package Manifests, the AUX entries must |
347 | continue to be present for the standard Portage deprecation cycle. |
359 | continue to be present for the standard Portage deprecation cycle. |
348 | The new entries may be included already in all Manifest files, as they |
360 | The new entries may be included already in all Manifest files, as they |
349 | will be ignored by older Portage versions. Over time, ECLASS, DATA, |
361 | will be ignored by older Portage versions. Over time, ECLASS, DATA, |
350 | EXEC, UNKNOWN may replace the existing AUX type.</p> |
362 | EXEC, OTHER may replace the existing AUX type.</p> |
351 | <p>The adoption of this proposal does also affect [#GLEP58] as part of |
363 | <p>The adoption of this proposal does also affect [#GLEP58] as part of |
352 | this GLEP series, however this GLEP was an offset of the research in |
364 | this GLEP series, however this GLEP was an offset of the research in |
353 | that GLEP.</p> |
365 | that GLEP.</p> |
354 | </div> |
366 | </div> |
355 | <div class="section" id="thanks-to"> |
367 | <div class="section" id="thanks-to"> |
… | |
… | |
367 | </tbody> |
379 | </tbody> |
368 | </table> |
380 | </table> |
369 | </div> |
381 | </div> |
370 | <div class="section" id="copyright"> |
382 | <div class="section" id="copyright"> |
371 | <h1><a class="toc-backref" href="#id30">Copyright</a></h1> |
383 | <h1><a class="toc-backref" href="#id30">Copyright</a></h1> |
372 | <p>Copyright (c) 2007 by Robin Hugh Johnson. This material may be |
384 | <p>Copyright (c) 2007-2010 by Robin Hugh Johnson. This material may be |
373 | distributed only subject to the terms and conditions set forth in the |
385 | distributed only subject to the terms and conditions set forth in the |
374 | Open Publication License, v1.0.</p> |
386 | Open Publication License, v1.0.</p> |
375 | <p>vim: tw=72 ts=2 expandtab:</p> |
387 | <p>vim: tw=72 ts=2 expandtab:</p> |
376 | </div> |
388 | </div> |
377 | |
389 | |
378 | </div> |
390 | </div> |
379 | <div class="footer"> |
391 | <div class="footer"> |
380 | <hr class="footer" /> |
392 | <hr class="footer" /> |
381 | <a class="reference external" href="glep-0060.txt">View document source</a>. |
393 | <a class="reference external" href="glep-0060.txt">View document source</a>. |
382 | Generated on: 2008-10-28 07:47 UTC. |
394 | Generated on: 2010-01-31 08:27 UTC. |
383 | Generated by <a class="reference external" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
395 | Generated by <a class="reference external" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
384 | |
396 | |
385 | </div> |
397 | </div> |
386 | </body> |
398 | </body> |
387 | </html> |
399 | </html> |