[Python-checkins] cpython (3.2): Move sys.subversion at the right place in alphabetical order, and informally

[antoine.pitrou]

http://hg.python.org/cpython/rev/fc8b5c6a021c
changeset:   71287:fc8b5c6a021c
branch:      3.2
parent:      71285:8bc9dbc61ba6
user:        Antoine Pitrou <solipsis at pitrou.net>
date:        Sat Jul 09 16:02:19 2011 +0200
summary:
  Move sys.subversion at the right place in alphabetical order, and informally deprecate it.

files:
  Doc/library/sys.rst |  30 ++++++++++++++++++------------
  1 files changed, 18 insertions(+), 12 deletions(-)


diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -36,18 +36,6 @@
    little-endian (least-significant byte first) platforms.
 
 
-.. data:: subversion
-
-   A triple (repo, branch, version) representing the Subversion information of the
-   Python interpreter. *repo* is the name of the repository, ``'CPython'``.
-   *branch* is a string of one of the forms ``'trunk'``, ``'branches/name'`` or
-   ``'tags/name'``. *version* is the output of ``svnversion``, if the interpreter
-   was built from a Subversion checkout; it contains the revision number (range)
-   and possibly a trailing 'M' if there were local modifications. If the tree was
-   exported (or svnversion was not available), it is the revision of
-   ``Include/patchlevel.h`` if the branch is a tag. Otherwise, it is ``None``.
-
-
 .. data:: builtin_module_names
 
    A tuple of strings giving the names of all modules that are compiled into this
@@ -982,6 +970,24 @@
        to a console and Python apps started with :program:`pythonw`.
 
 
+.. data:: subversion
+
+   A triple (repo, branch, version) representing the Subversion information of the
+   Python interpreter. *repo* is the name of the repository, ``'CPython'``.
+   *branch* is a string of one of the forms ``'trunk'``, ``'branches/name'`` or
+   ``'tags/name'``. *version* is the output of ``svnversion``, if the interpreter
+   was built from a Subversion checkout; it contains the revision number (range)
+   and possibly a trailing 'M' if there were local modifications. If the tree was
+   exported (or svnversion was not available), it is the revision of
+   ``Include/patchlevel.h`` if the branch is a tag. Otherwise, it is ``None``.
+
+   .. deprecated:: 3.2.1
+      Python is now `developed <http://docs.python.org/devguide/>`_ using
+      Mercurial.  In recent Python 3.2 bugfix releases, :data:`subversion`
+      therefore contains placeholder information.  It is removed in Python
+      3.3.
+
+
 .. data:: tracebacklimit
 
    When this variable is set to an integer value, it determines the maximum number

-- 
Repository URL: http://hg.python.org/cpython