| … | |
… | |
| 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.7</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/13 03:26:53</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> |
| … | |
… | |
| 111 | unless stated otherwise in the following sections. The Manifest file |
111 | unless stated otherwise in the following sections. The Manifest file |
| 112 | must not contain an entry for itself.</p> |
112 | must not contain an entry for itself.</p> |
| 113 | </div> |
113 | </div> |
| 114 | <div class="section" id="excluded-files"> |
114 | <div class="section" id="excluded-files"> |
| 115 | <h2><a class="toc-backref" href="#id8">Excluded files</a></h2> |
115 | <h2><a class="toc-backref" href="#id8">Excluded files</a></h2> |
| 116 | <p>When generating or validating a Manifest, or commiting to a version |
116 | <p>When generating or validating a Manifest, or committing to a version |
| 117 | control system, the package manager should endeavour to ignore files |
117 | control system, the package manager should endeavour to ignore files |
| 118 | created by a version control system, backup files from text editors. A |
118 | 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>, |
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>, |
| 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> |
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> |
| 121 | <p>Additionally, for a transitional Manifest1->Manifest2 system, old-style |
121 | <p>Additionally, for a transitional Manifest1->Manifest2 system, old-style |
| … | |
… | |
| 220 | <h3><a class="toc-backref" href="#id20">MANIFEST (new)</a></h3> |
220 | <h3><a class="toc-backref" href="#id20">MANIFEST (new)</a></h3> |
| 221 | <ul class="simple"> |
221 | <ul class="simple"> |
| 222 | <li>The MANIFEST type is explicitly to cover all nested Manifest files.</li> |
222 | <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 |
223 | <li>During validation, this serves as an indicator that the package |
| 224 | manager may need to check subtree Manifest file.</li> |
224 | manager may need to check subtree Manifest file.</li> |
| 225 | <li>A missing MANIFEST file may be treated as a minor (eg excluding an |
225 | <li>A missing MANIFEST file may be treated as a minor (e.g. excluding an |
| 226 | entire category) or critical validation failure.</li> |
226 | entire category) or critical validation failure.</li> |
| 227 | <li>The failure should be considered as critical only if files that would |
227 | <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 |
228 | be directly covered by this Manifest are missing. Deletion of a |
| 229 | category-level Manifest while preserving the packages is forbidden. |
229 | category-level Manifest while preserving the packages is forbidden. |
| 230 | Deletion of an entire category is not.</li> |
230 | Deletion of an entire category is not.</li> |
| … | |
… | |
| 248 | <div class="section" id="exec-new"> |
248 | <div class="section" id="exec-new"> |
| 249 | <h3><a class="toc-backref" href="#id23">EXEC (new)</a></h3> |
249 | <h3><a class="toc-backref" href="#id23">EXEC (new)</a></h3> |
| 250 | <ul class="simple"> |
250 | <ul class="simple"> |
| 251 | <li>uses _CRIT.</li> |
251 | <li>uses _CRIT.</li> |
| 252 | <li>If the file gets sourced, executed, or causes a change (patches) in |
252 | <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 |
253 | how something is sourced or executed, it belongs in the EXEC |
| 254 | filetype.</li> |
254 | filetype.</li> |
| 255 | <li>This filetype should be used for the scripts directories of a |
255 | <li>This filetype should be used for the scripts directories of a |
| 256 | repository for important files.</li> |
256 | repository for important files.</li> |
| 257 | <li>This filetype is not limited to being used in the files/ |
257 | <li>This filetype is not limited to being used in the files/ |
| 258 | subdirectory.</li> |
258 | subdirectory.</li> |
| … | |
… | |
| 336 | </dd> |
336 | </dd> |
| 337 | </dl> |
337 | </dl> |
| 338 | </li> |
338 | </li> |
| 339 | </ol> |
339 | </ol> |
| 340 | <p>The logic behind 5, 6, 7 is ensuring that every item that by it's |
340 | <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. |
341 | 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>, |
342 | (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 |
343 | where it blindly includes them, or alternatively, the package.mask file |
| 344 | or a profile being altered/missing).</p> |
344 | or a profile being altered/missing).</p> |
| 345 | <p>The above lists of file patterns are not intended to be exhaustive, |
345 | <p>The above lists of file patterns are not intended to be exhaustive, |
| 346 | but merely demonstrative.</p> |
346 | but merely demonstrative.</p> |
| … | |
… | |
| 375 | </tbody> |
375 | </tbody> |
| 376 | </table> |
376 | </table> |
| 377 | </div> |
377 | </div> |
| 378 | <div class="section" id="copyright"> |
378 | <div class="section" id="copyright"> |
| 379 | <h1><a class="toc-backref" href="#id30">Copyright</a></h1> |
379 | <h1><a class="toc-backref" href="#id30">Copyright</a></h1> |
| 380 | <p>Copyright (c) 2007 by Robin Hugh Johnson. This material may be |
380 | <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 |
381 | distributed only subject to the terms and conditions set forth in the |
| 382 | Open Publication License, v1.0.</p> |
382 | Open Publication License, v1.0.</p> |
| 383 | <p>vim: tw=72 ts=2 expandtab:</p> |
383 | <p>vim: tw=72 ts=2 expandtab:</p> |
| 384 | </div> |
384 | </div> |
| 385 | |
385 | |
| 386 | </div> |
386 | </div> |
| 387 | <div class="footer"> |
387 | <div class="footer"> |
| 388 | <hr class="footer" /> |
388 | <hr class="footer" /> |
| 389 | <a class="reference external" href="glep-0060.txt">View document source</a>. |
389 | <a class="reference external" href="glep-0060.txt">View document source</a>. |
| 390 | Generated on: 2010-01-13 00:54 UTC. |
390 | Generated on: 2010-01-13 03: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. |
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. |
| 392 | |
392 | |
| 393 | </div> |
393 | </div> |
| 394 | </body> |
394 | </body> |
| 395 | </html> |
395 | </html> |