[Python-checkins] python/nondist/peps pep-0314.txt,1.1,1.2

[akuchling@users.sourceforge.net]

Update of /cvsroot/python/python/nondist/peps
In directory sc8-pr-cvs1:/tmp/cvs-serv10630

Modified Files:
	pep-0314.txt 
Log Message:
Add Requires and Provides fields

Index: pep-0314.txt
===================================================================
RCS file: /cvsroot/python/python/nondist/peps/pep-0314.txt,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** pep-0314.txt	12 Apr 2003 19:45:01 -0000	1.1
--- pep-0314.txt	12 Apr 2003 20:16:20 -0000	1.2
***************
*** 1,10 ****
! PEP: 241
! Title: Metadata for Python Software Packages
  Version: $Revision$
  Author: A.M. Kuchling <amk@amk.ca>
  Type: Standards Track
! Created: 12-Mar-2001
! Status: Final
! Post-History: 19-Mar-2001
  
  Introduction
--- 1,10 ----
! PEP: 314
! Title: Metadata for Python Software Packages v1.1
  Version: $Revision$
  Author: A.M. Kuchling <amk@amk.ca>
  Type: Standards Track
! Created: 12-Apr-2003
! Status: Draft
! Post-History: 
  
  Introduction
***************
*** 14,17 ****
--- 14,19 ----
     semantics and usage.
  
+    This document specifies version 1.1 of the metadata format.
+    Version 1.0 is specified in PEP 241.
  
  Including Metadata in Packages
***************
*** 49,58 ****
      Metadata-Version
  
!       Version of the file format; currently "1.0" is the only
!       legal value here.  
  
        Example: 
  
!            Metadata-Version: 1.0
  
      Name
--- 51,60 ----
      Metadata-Version
  
!       Version of the file format; currently "1.0" and "1.1" are the
!       only legal values here.
  
        Example: 
  
!            Metadata-Version: 1.1
  
      Name
***************
*** 169,173 ****
        resellers can automatically know that they're free to
        redistribute the software.  Other licenses will require
!       a careful reading by a human to determine the software can be
        repackaged and resold.
  
--- 171,175 ----
        resellers can automatically know that they're free to
        redistribute the software.  Other licenses will require
!       a careful reading by a human to determine how the software can be
        repackaged and resold.
  
***************
*** 212,226 ****
            License: MIT
        
  
! Acknowledgements
  
!     Many changes and rewrites to this document were suggested by the
!     readers of the Distutils SIG.  In particular, Sean Reifschneider
!     often contributed actual text for inclusion in this PEP.
!  
!     The list of licenses was compiled using the SourceForge license
!     list and the CTAN license list compiled by Graham Williams; Carey
!     Evans also offered several useful suggestions on this list.
  
  
  Copyright
--- 214,279 ----
            License: MIT
        
+     Requires (multiple use)
+       
+       Each entry contains a string describing some other component or
+       module required by this package. 
  
!       The format of a requirement string is simple: an arbitrary
!       sequence of characters, optionally followed by a version
!       declaration within parentheses.  Leading and trailing whitespace
!       are ignored, and whitespace within the string is normalized to a
!       single space.
  
!       A version declaration is a series of conditional operators and
!       version numbers, separated by commas.  Conditional operators
!       must be one of "<", ">", "<=", ">=", "=", and "!=".  Version
!       numbers must be in the format accepted by the
!       distutils.version.StrictVersion class: two or three
!       dot-separated numeric components, with an optional "pre-release"
!       tag on the end consisting of the letter 'a' or 'b' followed by a
!       number.  Example version numbers are "1.0", "2.3a2", "1.3.99", 
! 
!       XXX Do we really need = and !=?
! 
!       XXX Should it be == or =?
! 
!       XXX Should we support LooseVersion instead of StrictVersion?
!       LooseVersions aren't comparable...
! 
!       Any number of conditional operators can be specified, e.g.
!       ">1.0, !=1.3.4, <2.0".
  
+       All of the following are possible requirement strings: "rfc822",
+       "", "zlib (>=1.1.4)", "XML parser".
+ 
+       There's no canonical list of what strings should be used; the
+       Python community is left to choose its own standards.
+ 
+       Example: 
+ 
+           Requires: re
+           Requires: sys
+           Requires: zlib
+           Requires: pyexpat (>1.0)
+           Requires: DB-API 2.0 module
+        
+     Provides (multiple use)
+ 
+       Each entry contains a string describing some other component or
+       module that will be provided by this package once it is
+       installed.  These strings should match the ones used in
+       Requirements fields.  Version declarations cannot be supplied;
+       instead the package's version number will be used.
+ 
+       Example: 
+ 
+           Provides: xml
+           Provides: xml.utils
+           Provides: xml.utils.iso8601
+           Provides: xml.dom
+ 
+ Acknowledgements
+ 
+     None yet.        
  
  Copyright