| … | |
… | |
| 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.6</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">2010/01/13 00:54:50</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> |
| … | |
… | |
| 45 | </tr> |
45 | </tr> |
| 46 | <tr class="field"><th class="field-name">Updated:</th><td class="field-body">June 2008, July 2008, October 2008, January 2010</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">December 2009</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"> |
| … | |
… | |
| 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">CVS/</tt>, <tt class="docutils literal">.svn/</tt>, <tt class="docutils literal">.bzr/</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">.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> |
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 |
| … | |
… | |
| 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> |
| … | |
… | |
| 248 | <div class="section" id="exec-new"> |
252 | <div class="section" id="exec-new"> |
| 249 | <h3><a class="toc-backref" href="#id23">EXEC (new)</a></h3> |
253 | <h3><a class="toc-backref" href="#id23">EXEC (new)</a></h3> |
| 250 | <ul class="simple"> |
254 | <ul class="simple"> |
| 251 | <li>uses _CRIT.</li> |
255 | <li>uses _CRIT.</li> |
| 252 | <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 |
| 253 | how something is sourced or execututed, it belongs in the EXEC |
257 | how something is sourced or executed, it belongs in the EXEC |
| 254 | filetype.</li> |
258 | filetype.</li> |
| 255 | <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 |
| 256 | repository for important files.</li> |
260 | repository for important files.</li> |
| 257 | <li>This filetype is not limited to being used in the files/ |
261 | <li>This filetype is not limited to being used in the files/ |
| 258 | subdirectory.</li> |
262 | subdirectory.</li> |
| … | |
… | |
| 336 | </dd> |
340 | </dd> |
| 337 | </dl> |
341 | </dl> |
| 338 | </li> |
342 | </li> |
| 339 | </ol> |
343 | </ol> |
| 340 | <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 |
| 341 | presence or absense may be dangerous should always be treated strictly. |
345 | presence or absence may be dangerous should always be treated strictly. |
| 342 | (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>, |
| 343 | where it blindly includes them, or alternatively, the package.mask file |
347 | where it blindly includes them, or alternatively, the package.mask file |
| 344 | or a profile being altered/missing).</p> |
348 | or a profile being altered/missing).</p> |
| 345 | <p>The above lists of file patterns are not intended to be exhaustive, |
349 | <p>The above lists of file patterns are not intended to be exhaustive, |
| 346 | but merely demonstrative.</p> |
350 | but merely demonstrative.</p> |
| … | |
… | |
| 375 | </tbody> |
379 | </tbody> |
| 376 | </table> |
380 | </table> |
| 377 | </div> |
381 | </div> |
| 378 | <div class="section" id="copyright"> |
382 | <div class="section" id="copyright"> |
| 379 | <h1><a class="toc-backref" href="#id30">Copyright</a></h1> |
383 | <h1><a class="toc-backref" href="#id30">Copyright</a></h1> |
| 380 | <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 |
| 381 | 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 |
| 382 | Open Publication License, v1.0.</p> |
386 | Open Publication License, v1.0.</p> |
| 383 | <p>vim: tw=72 ts=2 expandtab:</p> |
387 | <p>vim: tw=72 ts=2 expandtab:</p> |
| 384 | </div> |
388 | </div> |
| 385 | |
389 | |
| 386 | </div> |
390 | </div> |
| 387 | <div class="footer"> |
391 | <div class="footer"> |
| 388 | <hr class="footer" /> |
392 | <hr class="footer" /> |
| 389 | <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>. |
| 390 | Generated on: 2010-01-13 00:54 UTC. |
394 | Generated on: 2010-01-31 08:27 UTC. |
| 391 | 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. |
| 392 | |
396 | |
| 393 | </div> |
397 | </div> |
| 394 | </body> |
398 | </body> |
| 395 | </html> |
399 | </html> |
Parent Directory
| 
Revision Log
| 
Patch