[Python-checkins] r86225 - in python/branches/release27-maint/Doc/library: ast.rst calendar.rst collections.rst queue.rst random.rst textwrap.rst threading.rst userdict.rst

[raymond.hettinger]

Author: raymond.hettinger
Date: Sat Nov  6 00:58:42 2010
New Revision: 86225

Log:
Provide links to Python source in a handful of
cases where the source is a generally helpful
adjunct to the docs.



Modified:
   python/branches/release27-maint/Doc/library/ast.rst
   python/branches/release27-maint/Doc/library/calendar.rst
   python/branches/release27-maint/Doc/library/collections.rst
   python/branches/release27-maint/Doc/library/queue.rst
   python/branches/release27-maint/Doc/library/random.rst
   python/branches/release27-maint/Doc/library/textwrap.rst
   python/branches/release27-maint/Doc/library/threading.rst
   python/branches/release27-maint/Doc/library/userdict.rst

Modified: python/branches/release27-maint/Doc/library/ast.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/ast.rst	(original)
+++ python/branches/release27-maint/Doc/library/ast.rst	Sat Nov  6 00:58:42 2010
@@ -28,6 +28,11 @@
 compiled into a Python code object using the built-in :func:`compile` function.
 
 
+.. seealso::
+
+   Latest version of the `ast module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/ast.py?view=markup>`_
+
 Node classes
 ------------
 

Modified: python/branches/release27-maint/Doc/library/calendar.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/calendar.rst	(original)
+++ python/branches/release27-maint/Doc/library/calendar.rst	Sat Nov  6 00:58:42 2010
@@ -22,6 +22,10 @@
 calendar in Dershowitz and Reingold's book "Calendrical Calculations", where
 it's the base calendar for all computations.
 
+.. seealso::
+
+   Latest version of the `calendar module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/calendar.py?view=markup>`_
 
 .. class:: Calendar([firstweekday])
 

Modified: python/branches/release27-maint/Doc/library/collections.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/collections.rst	(original)
+++ python/branches/release27-maint/Doc/library/collections.rst	Sat Nov  6 00:58:42 2010
@@ -44,6 +44,10 @@
 provides a particular interface, for example, whether it is hashable or
 a mapping.
 
+.. seealso::
+
+   Latest version of the `collections module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/collections.py?view=markup>`_
 
 :class:`Counter` objects
 ------------------------
@@ -970,6 +974,9 @@
 
 .. seealso::
 
+   * Latest version of the `Python source code for the collections abstract base classes
+     <http://svn.python.org/view/python/branches/release27-maint/Lib/_abcoll.py?view=markup>`_
+
    * `OrderedSet recipe <http://code.activestate.com/recipes/576694/>`_ for an
      example built on :class:`MutableSet`.
 

Modified: python/branches/release27-maint/Doc/library/queue.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/queue.rst	(original)
+++ python/branches/release27-maint/Doc/library/queue.rst	Sat Nov  6 00:58:42 2010
@@ -24,6 +24,11 @@
 the entries are kept sorted (using the :mod:`heapq` module) and the
 lowest valued entry is retrieved first.
 
+.. seealso::
+
+   Latest version of the `queue module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/queue.py?view=markup>`_
+
 The :mod:`Queue` module defines the following classes and exceptions:
 
 .. class:: Queue(maxsize=0)

Modified: python/branches/release27-maint/Doc/library/random.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/random.rst	(original)
+++ python/branches/release27-maint/Doc/library/random.rst	Sat Nov  6 00:58:42 2010
@@ -9,6 +9,11 @@
 This module implements pseudo-random number generators for various
 distributions.
 
+.. seealso::
+
+   Latest version of the `random module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/random.py?view=markup>`_
+
 For integers, uniform selection from a range. For sequences, uniform selection
 of a random element, a function to generate a random permutation of a list
 in-place, and a function for random sampling without replacement.

Modified: python/branches/release27-maint/Doc/library/textwrap.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/textwrap.rst	(original)
+++ python/branches/release27-maint/Doc/library/textwrap.rst	Sat Nov  6 00:58:42 2010
@@ -16,6 +16,10 @@
 or two  text strings, the convenience functions should be good enough;
 otherwise,  you should use an instance of :class:`TextWrapper` for efficiency.
 
+.. seealso::
+
+   Latest version of the `textwrap module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/textwrap.py?view=markup>`_
 
 .. function:: wrap(text[, width[, ...]])
 

Modified: python/branches/release27-maint/Doc/library/threading.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/threading.rst	(original)
+++ python/branches/release27-maint/Doc/library/threading.rst	Sat Nov  6 00:58:42 2010
@@ -26,6 +26,10 @@
    Starting with Python 2.5, several Thread methods raise :exc:`RuntimeError`
    instead of :exc:`AssertionError` if called erroneously.
 
+.. seealso::
+
+   Latest version of the `threading module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/threading.py?view=markup>`_
 
 This module defines the following functions and objects:
 

Modified: python/branches/release27-maint/Doc/library/userdict.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/userdict.rst	(original)
+++ python/branches/release27-maint/Doc/library/userdict.rst	Sat Nov  6 00:58:42 2010
@@ -19,6 +19,11 @@
 sub-classes that obtained new behaviors by overriding existing methods or adding
 new ones.
 
+.. seealso::
+
+   Latest version of the `UserDict Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/UserDict.py?view=markup>`_
+
 The :mod:`UserDict` module defines the :class:`UserDict` class and
 :class:`DictMixin`: