[gentoo-commits] gentoo commit in xml/htdocs/proj/en/glep: glep-0060.txt

[Robin H. Johnson (robbat2)]

robbat2     08/10/28 07:46:51

  Modified:             glep-0060.txt
  Log:
  Fix ReST validation by using ``inline literals`` for some expressions that would otherwise mean *emphasis*. Fix references and headers.

Revision  Changes    Path
1.3                  xml/htdocs/proj/en/glep/glep-0060.txt

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/glep/glep-0060.txt?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/glep/glep-0060.txt?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/glep/glep-0060.txt?r1=1.2&r2=1.3

Index: glep-0060.txt
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/glep/glep-0060.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -p -w -b -B -u -u -r1.2 -r1.3
--- glep-0060.txt	22 Oct 2008 17:59:43 -0000	1.2
+++ glep-0060.txt	28 Oct 2008 07:46:51 -0000	1.3
@@ -1,24 +1,25 @@
 GLEP: 60
 Title: Manifest2 filetypes
-Version: $Revision: 1.2 $
-Last-Modified: $Date: 2008/10/22 17:59:43 $
+Version: $Revision: 1.3 $
+Last-Modified: $Date: 2008/10/28 07:46:51 $
 Author: Robin Hugh Johnson <robbat2@g.o> 
 Status: Draft
 Type: Standards Track
 Content-Type: text/x-rst
 Requires: 44
 Created: November 2007
-Updated: June 2008, July 2008
+Updated: June 2008, July 2008, October 2008
 Updates: 44
+Post-History:
 
 Abstract
 ========
-Clarification of the Manifest2 [GLEP44] specification, including new types to
+Clarification of the Manifest2 [#GLEP44] specification, including new types to
 help in the tree-signing specification.
 
 Motivation
 ==========
-[GLEP44] was not entirely clear on the usage of filetype specifiers.
+[#GLEP44] was not entirely clear on the usage of filetype specifiers.
 This document serves to provide some of the internal logic used by
 Portage at the point of writing, as well as adding new types to cover
 the rest of the tree, for the purposes of tree-signing coverage.
@@ -37,8 +38,8 @@ Excluded files
 When generating or validating a Manifest, or commiting to a version
 control system, the package manager should endeavour to ignore files
 created by a version control system, backup files from text editors. A
-non-exhaustive list is suggested here: CVS/, .svn/, .bzr/, .git/, .hg/,
-.#*, *.rej, *.orig, *.bak, *~.
+non-exhaustive list is suggested here: ``CVS/``, ``.svn/``, ``.bzr/``,
+``.git/``, ``.hg/``, ``.#*``, ``*.rej``, ``*.orig``, ``*.bak``, ``*~``.
 
 Additionally, for a transitional Manifest1->Manifest2 system, old-style
 digest files located in a 'files/' directory, may be excluded from
@@ -171,28 +172,28 @@ Chosing a filetype
 ------------------
 1. matches Manifest 
     => MANIFEST, stop.
-2. matches *.ebuild 
+2. matches ``*.ebuild``
     => EBUILD, stop.
-3. matches *.eclass 
+3. matches ``*.eclass``
     => ECLASS, stop.
 4. listed in SRC_URI 
     => DIST, stop.
-5. matches files/* 
+5. matches ``files/*``
     => AUX, continue [see note].
-6. matches {*.sh,*.bashrc,*.patch,...} 
+6. matches any of ``*.sh``, ``*.bashrc``, ``*.patch``, ...
     => EXEC, stop.
-7. matches {metadata/cache/*,profiles/,package.*,use.mask*,...} 
+7. matches any of ``metadata/cache/*``, ``profiles/``, ``package.*``, ``use.mask*``, ...
     => DATA, stop.
-8. matches {ChangeLog,metadata.xml,*.desc,...} 
+8. matches any of ``ChangeLog``, ``metadata.xml``, ``*.desc``, ...
     => MISC, stop.
 9. not matched by any other rule 
     => UNKNOWN, stop.
 
 The logic behind 5, 6, 7 is ensuring that every item that by it's
 presence or absense may be dangerous should always be treated strictly.
-(Consider epatch given a directory of patches ${FILESDIR}/${PV}/, where
-it blindly includes them, or alternatively, the package.mask file or a
-profile being altered/missing).
+(Consider epatch given a directory of patches ``${FILESDIR}/${PV}/``,
+where it blindly includes them, or alternatively, the package.mask file
+or a profile being altered/missing).
 
 Note: The AUX entries should only be generated if we are generating a
 compatible Manifest that supports older versions of Portage. They should
@@ -206,7 +207,7 @@ The new entries may be included already 
 will be ignored by older Portage versions. Over time, ECLASS, DATA,
 EXEC, UNKNOWN may replace the existing AUX type.
 
-The adoption of this proposal does also affect [GLEPxx+1] as part of
+The adoption of this proposal does also affect [#GLEP58] as part of
 this GLEP series, however this GLEP was an offset of the research in
 that GLEP.