[Python-checkins] r76476 - in peps/trunk: pep-0345.txt pep-0386.txt

[tarek.ziade]

Author: tarek.ziade
Date: Tue Nov 24 10:14:32 2009
New Revision: 76476

Log:
added three fields for the project URLs: Repository-URL, Repository-Browser-URL, Bug-Tracker-URL

Modified:
   peps/trunk/pep-0345.txt
   peps/trunk/pep-0386.txt

Modified: peps/trunk/pep-0345.txt
==============================================================================
--- peps/trunk/pep-0345.txt	(original)
+++ peps/trunk/pep-0345.txt	Tue Nov 24 10:14:32 2009
@@ -9,7 +9,7 @@
 Content-Type: text/x-rst
 Created: 28-Apr-2005
 Python-Version: 2.5
-Post-History: 
+Post-History:
 Replaces: 314
 
 
@@ -162,7 +162,7 @@
 Maintainer (optional)
     A string containing the maintainer's name at a minimum; additional
     contact information may be provided.
-    
+
     Note that this field is intended for use when a package is being
     maintained by someone other than the original author:  it should be
     omitted if it is identical to ``Author``.
@@ -295,7 +295,7 @@
     version numbers, separated by commas.  Conditional operators
     must be one of "<", ">", "<=", ">=", "==", and "!=".  Version
     numbers must be in the format specified in `PEP 386`_.
-    If no operator is provided with a version, the "==" operator 
+    If no operator is provided with a version, the "==" operator
     is used by default.
 
     Any number of conditional operators can be specified, e.g.
@@ -326,7 +326,7 @@
     RDBMS bindings for use by a given ORM:  each project might declare
     that it provides ``ORM-bindings``, allowing other projects to depend
     only on having at most one of them installed.
- 
+
     A version declaration may be supplied (without a comparison
     operator); the distribution's version number will be implied if none
     is specified.  Version numbers must be in the format specified in
@@ -342,7 +342,7 @@
     Each entry contains a string describing a distutils project which
     this package renders obsolete, meaning that the two packages
     should not be installed at the same time.
-    
+
     Version declarations can be supplied.  Version numbers must be in the
     format specified in `PEP 386`_.
 
@@ -387,10 +387,10 @@
 
     A version declaration is a series of conditional operators and
     version numbers, separated by commas.  Conditional operators
-    must be one of "<", ">", "<=", ">=", "==", and "!=". If no 
+    must be one of "<", ">", "<=", ">=", "==", and "!=". If no
     operator is provided with a version, the "==" operator is used by default.
 
-    Because they refer to non-Python software releases, version numbers 
+    Because they refer to non-Python software releases, version numbers
     for this field are **not** required to conform to the format
     specified in `PEP 386`_:  they should correspond to the
     version scheme used by the external dependency.
@@ -416,6 +416,31 @@
        Copyright: Python Software Foundation, 2005
        Copyright: Public Domain
 
+
+Repository-URL
+    A string containing the URL for the project repository.
+
+    Example::
+
+        Repository-URL: http://svn.python.org/projects/python/trunk/
+
+
+Repository-Browse-URL
+    A string containing the URL for the project browsable repository.
+
+    Example::
+
+        Repository-Browse-URL: http://svn.python.org/view/python/trunk
+
+
+Bug-Tracker-URL
+    A string containing the URL for the package's bug tracker
+
+    Example::
+
+        Bug-Tracker-URL: http://bugs.python.org/
+
+
 Version Specifiers
 ==================
 
@@ -432,13 +457,13 @@
 
 Here are some example of fields using such markers::
 
-   Requires-Dist: pywin32, bar > 1.0; sys.platform == 'win32'
+   Requires-Dist: pywin32 > 1.0; sys.platform == 'win32'
    Obsoletes-Dist: pywin31; sys.platform == 'win32'
    Requires-Dist: foo; os.machine == 'i386'
    Requires-Dist: bar; python_version == '2.4' or python_version == '2.5'
    Requires-External: libxslt; 'linux' in sys.platform
 
-These markers are using a micro-language that can be interpreted using a 
+These markers are using a micro-language that can be interpreted using a
 function ``interpret_marker`` provided in the ``distutils.util`` module
 in the stdlib::
 
@@ -446,7 +471,7 @@
     >>> interpret_marker("sys.platform == 'win32'")
     True
 
-Depending if the execution environment meets the requirements, the function 
+Depending if the execution environment meets the requirements, the function
 will return True or False.
 
 The micro-language behind this is the simplest possible: it compares only
@@ -496,6 +521,9 @@
   - Requires-Dist
   - Provides-Dist
   - Obsoletes-Dist
+  - Repository-URL
+  - Repository-Browser-URL
+  - Bug-Tracker-URL
 
 * Deprecated fields:
 
@@ -532,7 +560,7 @@
 Fred Drake, Anthony Baxter and Matthias Klose have all contributed to
 the ideas presented in this PEP.
 
-Tres Seaver, Jim Fulton, Marc-André Lemburg, Tarek Ziadé and other people at 
+Tres Seaver, Jim Fulton, Marc-André Lemburg, Tarek Ziadé and other people at
 the Distutils-SIG have contributed to the new updated version.
 
 

Modified: peps/trunk/pep-0386.txt
==============================================================================
--- peps/trunk/pep-0386.txt	(original)
+++ peps/trunk/pep-0386.txt	Tue Nov 24 10:14:32 2009
@@ -283,7 +283,7 @@
 be a ``1.2.0-r678`` release. We used ``post`` instead of ``r`` because the 
 ``r`` is ambiguous as to whether it indicates a pre- or post-release.
 
-Last, ``.post456.dev34`` indicates a dev parker for a post release, that sorts
+Last, ``.post456.dev34`` indicates a dev marker for a post release, that sorts
 before a ``.post345`` marker. This can be used to do development versions
 of post releases.