From 73705902c4eb00902d2eaef50fe36ab3b76184b3 Mon Sep 17 00:00:00 2001 From: Antoine Pitrou Date: Sat, 9 Jul 2011 16:06:19 +0200 Subject: [PATCH] Move sys.subversion at the right place in alphabetical order, and add a note concerning its status. --- Doc/library/sys.rst | 34 ++++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 14 deletions(-) diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 32ec03d539f..6df371f2e12 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -32,20 +32,6 @@ always available. .. versionadded:: 2.0 -.. 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``. - - .. versionadded:: 2.5 - - .. data:: builtin_module_names A tuple of strings giving the names of all modules that are compiled into this @@ -992,6 +978,26 @@ always available. replacing it, and restore the saved object. +.. 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``. + + .. versionadded:: 2.5 + + .. note:: + Python is now `developed `_ using + Mercurial. In recent Python 2.7 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