Add more links to Python sources where the code is short, readable and an...

Add more links to Python sources where the code is short, readable and an informative adjunct to the docs.

Doc/library/atexit.rst

@@ -14,6 +14,11 @@ The :mod:`atexit` module defines a single function to register cleanup
 functions.  Functions thus registered are automatically executed upon normal
 interpreter termination.
 
+.. seealso::
+
+   Latest version of the `atexit Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/atexit.py?view=markup>`_
+
 Note: the functions registered via this module are not called when the program
 is killed by a signal, when a Python fatal internal error is detected, or when
 :func:`os._exit` is called.

Doc/library/bisect.rst

@@ -16,6 +16,11 @@ example of the algorithm (the boundary conditions are already right!).
 
 .. versionadded:: 2.1
 
+.. seealso::
+
+   Latest version of the `bisect module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/bisect.py?view=markup>`_
+
 The following functions are provided:
 
 

Doc/library/cmd.rst

@@ -12,6 +12,10 @@ command interpreters.  These are often useful for test harnesses, administrative
 tools, and prototypes that will later be wrapped in a more sophisticated
 interface.
 
+.. seealso::
+
+   Latest version of the `cmd module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/cmd.py?view=markup>`_
 
 .. class:: Cmd([completekey[, stdin[, stdout]]])
 

Doc/library/contextlib.rst

@@ -11,6 +11,11 @@ This module provides utilities for common tasks involving the :keyword:`with`
 statement. For more information see also :ref:`typecontextmanager` and
 :ref:`context-managers`.
 
+.. seealso::
+
+   Latest version of the `contextlib Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/contextlib.py?view=markup>`_
+
 Functions provided:
 
 

Doc/library/dis.rst

@@ -11,6 +11,11 @@ disassembling it. The CPython bytecode which this module takes as an
 input is defined in the file :file:`Include/opcode.h` and used by the compiler
 and the interpreter.
 
+.. seealso::
+
+   Latest version of the `dis module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/dis.py?view=markup>`_
+
 .. impl-detail::
 
    Bytecode is an implementation detail of the CPython interpreter!  No

Doc/library/filecmp.rst

@@ -11,6 +11,11 @@ The :mod:`filecmp` module defines functions to compare files and directories,
 with various optional time/correctness trade-offs. For comparing files,
 see also the :mod:`difflib` module.
 
+.. seealso::
+
+   Latest version of the `filecmp Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/filecmp.py?view=markup>`_
+
 The :mod:`filecmp` module defines the following functions:
 
 

Doc/library/fileinput.rst

@@ -44,6 +44,11 @@ hook must be a function that takes two arguments, *filename* and *mode*, and
 returns an accordingly opened file-like object. Two useful hooks are already
 provided by this module.
 
+.. seealso::
+
+   Latest version of the `fileinput Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/fileinput.py?view=markup>`_
+
 The following function is the primary interface of this module:
 
 

Doc/library/fnmatch.rst

@@ -34,6 +34,10 @@ module.  See module :mod:`glob` for pathname expansion (:mod:`glob` uses
 a period are not special for this module, and are matched by the ``*`` and ``?``
 patterns.
 
+.. seealso::
+
+   Latest version of the `fnmatch Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/fnmatch.py?view=markup>`_
 
 .. function:: fnmatch(filename, pattern)
 

Doc/library/functools.rst

@@ -15,6 +15,11 @@ The :mod:`functools` module is for higher-order functions: functions that act on
 or return other functions. In general, any callable object can be treated as a
 function for the purposes of this module.
 
+.. seealso::
+
+   Latest version of the `functools Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/functools.py?view=markup>`_
+
 The :mod:`functools` module defines the following functions:
 
 ..  function:: cmp_to_key(func)

Doc/library/glob.rst

@@ -16,6 +16,10 @@ matched.  This is done by using the :func:`os.listdir` and
 subshell.  (For tilde and shell variable expansion, use
 :func:`os.path.expanduser` and :func:`os.path.expandvars`.)
 
+.. seealso::
+
+   Latest version of the `glob module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/glob.py?view=markup>`_
 
 .. function:: glob(pathname)
 

Doc/library/heapq.rst

@@ -13,6 +13,11 @@
 This module provides an implementation of the heap queue algorithm, also known
 as the priority queue algorithm.
 
+.. seealso::
+
+   Latest version of the `heapq Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/heapq.py?view=markup>`_
+
 Heaps are arrays for which ``heap[k] <= heap[2*k+1]`` and ``heap[k] <=
 heap[2*k+2]`` for all *k*, counting elements from zero.  For the sake of
 comparison, non-existing elements are considered to be infinite.  The

Doc/library/keyword.rst

@@ -20,3 +20,8 @@ This module allows a Python program to determine if a string is a keyword.
    keywords are defined to only be active when particular :mod:`__future__`
    statements are in effect, these will be included as well.
 
+
+.. seealso::
+
+   Latest version of the `keyword module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/keyword.py?view=markup>`_

Doc/library/linecache.rst

@@ -12,6 +12,11 @@ attempting to optimize internally, using a cache, the common case where many
 lines are read from a single file.  This is used by the :mod:`traceback` module
 to retrieve source lines for inclusion in  the formatted traceback.
 
+.. seealso::
+
+   Latest version of the `linecache module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/linecache.py?view=markup>`_
+
 The :mod:`linecache` module defines the following functions:
 
 

Doc/library/pprint.rst

@@ -28,6 +28,11 @@ width constraint.
 .. versionchanged:: 2.6
    Added support for :class:`set` and :class:`frozenset`.
 
+.. seealso::
+
+   Latest version of the `pprint module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/pprint.py?view=markup>`_
+
 The :mod:`pprint` module defines one class:
 
 .. First the implementation class:

Doc/library/quopri.rst

@@ -18,6 +18,10 @@ few nonprintable characters; the base64 encoding scheme available via the
 :mod:`base64` module is more compact if there are many such characters, as when
 sending a graphics file.
 
+.. seealso::
+
+   Latest version of the `quopri module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/quopri.py?view=markup>`_
 
 .. function:: decode(input, output[,header])
 

Doc/library/repr.rst

@@ -15,6 +15,11 @@ The :mod:`repr` module provides a means for producing object representations
 with limits on the size of the resulting strings. This is used in the Python
 debugger and may be useful in other contexts as well.
 
+.. seealso::
+
+   Latest version of the `repr module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/repr.py?view=markup>`_
+
 This module provides a class, an instance, and a function:
 
 

Doc/library/sched.rst

@@ -10,6 +10,10 @@
 The :mod:`sched` module defines a class which implements a general purpose event
 scheduler:
 
+.. seealso::
+
+   Latest version of the `sched module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/sched.py?view=markup>`_
 
 .. class:: scheduler(timefunc, delayfunc)
 

Doc/library/shelve.rst

@@ -13,6 +13,10 @@ arbitrary Python objects --- anything that the :mod:`pickle` module can handle.
 This includes most class instances, recursive data types, and objects containing
 lots of shared  sub-objects.  The keys are ordinary strings.
 
+.. seealso::
+
+   Latest version of the `shelve module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/shelve.py?view=markup>`_
 
 .. function:: open(filename[, flag='c'[, protocol=None[, writeback=False]]])
 

Doc/library/shutil.rst

@@ -16,6 +16,11 @@ collections of files.  In particular, functions are provided  which support file
 copying and removal. For operations on individual files, see also the
 :mod:`os` module.
 
+.. seealso::
+
+   Latest version of the `shutil module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/shutil.py?view=markup>`_
+
 .. warning::
 
    Even the higher-level file copying functions (:func:`copy`, :func:`copy2`)
@@ -27,6 +32,7 @@ copying and removal. For operations on individual files, see also the
    not be correct. On Windows, file owners, ACLs and alternate data streams
    are not copied.
 
+
 Directory and files operations
 ------------------------------
 

Doc/library/string.rst

@@ -17,6 +17,11 @@ template strings or the ``%`` operator described in the
 :ref:`string-formatting` section. Also, see the :mod:`re` module for
 string functions based on regular expressions.
 
+.. seealso::
+
+   Latest version of the `string module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/string.py?view=markup>`_
+
 
 String constants
 ----------------

Doc/library/tokenize.rst

@@ -13,6 +13,11 @@ implemented in Python.  The scanner in this module returns comments as tokens as
 well, making it useful for implementing "pretty-printers," including colorizers
 for on-screen displays.
 
+.. seealso::
+
+   Latest version of the `tokenize module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/tokenize.py?view=markup>`_
+
 The primary entry point is a :term:`generator`:
 
 .. function:: generate_tokens(readline)

Doc/library/trace.rst

@@ -11,6 +11,10 @@ annotated statement coverage listings, print caller/callee relationships and
 list functions executed during a program run.  It can be used in another program
 or from the command line.
 
+.. seealso::
+
+   Latest version of the `trace module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/trace.py?view=markup>`_
 
 .. _trace-cli:
 

Doc/library/urlparse.rst

@@ -33,6 +33,11 @@ following URL schemes: ``file``, ``ftp``, ``gopher``, ``hdl``, ``http``,
 .. versionadded:: 2.5
    Support for the ``sftp`` and ``sips`` schemes.
 
+.. seealso::
+
+   Latest version of the `urlparse module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/urlparse.py?view=markup>`_
+
 The :mod:`urlparse` module defines the following functions:
 
 

Doc/library/uu.rst

@@ -22,6 +22,11 @@ that, when required, the mode is ``'rb'`` or ``'wb'`` on Windows.
 
 This code was contributed by Lance Ellinghouse, and modified by Jack Jansen.
 
+.. seealso::
+
+   Latest version of the `uu module Python source code
+   <http://svn.python.org/view/python/branches/release27-maint/Lib/uu.py?view=markup>`_
+
 The :mod:`uu` module defines the following functions: