summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2011-01-10 19:54:11 +0000
committerRaymond Hettinger <python@rcn.com>2011-01-10 19:54:11 +0000
commit4f707fd3165dad9cdf0307b610593a32bfcd456e (patch)
tree684fff97ff4e77a9b04a51c8ded1b4d0f4cb36ed
parent04da1e013a6ad54b417d52b6c5e1312b18a67ae9 (diff)
downloadcpython-git-4f707fd3165dad9cdf0307b610593a32bfcd456e.tar.gz
Separate source link from main text.
-rw-r--r--Doc/library/ast.rst2
-rw-r--r--Doc/library/bisect.rst2
-rw-r--r--Doc/library/calendar.rst2
-rw-r--r--Doc/library/cmd.rst2
-rw-r--r--Doc/library/collections.rst2
-rw-r--r--Doc/library/contextlib.rst2
-rw-r--r--Doc/library/dis.rst2
-rw-r--r--Doc/library/filecmp.rst2
-rw-r--r--Doc/library/fileinput.rst2
-rw-r--r--Doc/library/fnmatch.rst2
-rw-r--r--Doc/library/glob.rst2
-rw-r--r--Doc/library/heapq.rst2
-rw-r--r--Doc/library/keyword.rst2
-rw-r--r--Doc/library/linecache.rst2
-rw-r--r--Doc/library/pprint.rst2
-rw-r--r--Doc/library/queue.rst2
-rw-r--r--Doc/library/random.rst2
-rw-r--r--Doc/library/sched.rst2
-rw-r--r--Doc/library/shelve.rst2
-rw-r--r--Doc/library/shutil.rst2
-rw-r--r--Doc/library/string.rst2
-rw-r--r--Doc/library/textwrap.rst2
-rw-r--r--Doc/library/threading.rst2
-rw-r--r--Doc/library/tokenize.rst2
-rw-r--r--Doc/library/trace.rst2
-rw-r--r--Doc/library/uu.rst2
-rw-r--r--Doc/whatsnew/3.2.rst2
27 files changed, 53 insertions, 1 deletions
diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index b5e08cbd53..ca8af56f2d 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -9,6 +9,8 @@
**Source code:** :source:`Lib/ast.py`
+--------------
+
The :mod:`ast` module helps Python applications to process trees of the Python
abstract syntax grammar. The abstract syntax itself might change with each
Python release; this module helps to find out programmatically what the current
diff --git a/Doc/library/bisect.rst b/Doc/library/bisect.rst
index 98955e6aae..13b0147190 100644
--- a/Doc/library/bisect.rst
+++ b/Doc/library/bisect.rst
@@ -9,6 +9,8 @@
**Source code:** :source:`Lib/bisect.py`
+--------------
+
This module provides support for maintaining a list in sorted order without
having to sort the list after each insertion. For long lists of items with
expensive comparison operations, this can be an improvement over the more common
diff --git a/Doc/library/calendar.rst b/Doc/library/calendar.rst
index 06a12cdd8f..f4952711cb 100644
--- a/Doc/library/calendar.rst
+++ b/Doc/library/calendar.rst
@@ -8,6 +8,8 @@
**Source code:** :source:`Lib/calendar.py`
+--------------
+
This module allows you to output calendars like the Unix :program:`cal` program,
and provides additional useful functions related to the calendar. By default,
these calendars have Monday as the first day of the week, and Sunday as the last
diff --git a/Doc/library/cmd.rst b/Doc/library/cmd.rst
index a0ae42510d..464764d793 100644
--- a/Doc/library/cmd.rst
+++ b/Doc/library/cmd.rst
@@ -7,6 +7,8 @@
**Source code:** :source:`Lib/cmd.py`
+--------------
+
The :class:`Cmd` class provides a simple framework for writing line-oriented
command interpreters. These are often useful for test harnesses, administrative
tools, and prototypes that will later be wrapped in a more sophisticated
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index d5ade412e4..4096cbbad5 100644
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -14,6 +14,8 @@
**Source code:** :source:`Lib/collections.py`
+--------------
+
This module implements specialized container datatypes providing alternatives to
Python's general purpose built-in containers, :class:`dict`, :class:`list`,
:class:`set`, and :class:`tuple`.
diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
index 5c56a5d494..a35ea569c1 100644
--- a/Doc/library/contextlib.rst
+++ b/Doc/library/contextlib.rst
@@ -6,6 +6,8 @@
**Source code:** :source:`Lib/contextlib.py`
+--------------
+
This module provides utilities for common tasks involving the :keyword:`with`
statement. For more information see also :ref:`typecontextmanager` and
:ref:`context-managers`.
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 1d21c49f3b..79cc583b75 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -6,6 +6,8 @@
**Source code:** :source:`Lib/dis.py`
+--------------
+
The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by
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
diff --git a/Doc/library/filecmp.rst b/Doc/library/filecmp.rst
index ead8588054..e0ffff704e 100644
--- a/Doc/library/filecmp.rst
+++ b/Doc/library/filecmp.rst
@@ -7,6 +7,8 @@
**Source code:** :source:`Lib/filecmp.py`
+--------------
+
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.
diff --git a/Doc/library/fileinput.rst b/Doc/library/fileinput.rst
index 1e71ebdcb9..ac4431145d 100644
--- a/Doc/library/fileinput.rst
+++ b/Doc/library/fileinput.rst
@@ -8,6 +8,8 @@
**Source code:** :source:`Lib/fileinput.py`
+--------------
+
This module implements a helper class and functions to quickly write a
loop over standard input or a list of files. If you just want to read or
write one file see :func:`open`.
diff --git a/Doc/library/fnmatch.rst b/Doc/library/fnmatch.rst
index 3b9a6c3aeb..4ba6b77f8e 100644
--- a/Doc/library/fnmatch.rst
+++ b/Doc/library/fnmatch.rst
@@ -11,6 +11,8 @@
**Source code:** :source:`Lib/fnmatch.py`
+--------------
+
This module provides support for Unix shell-style wildcards, which are *not* the
same as regular expressions (which are documented in the :mod:`re` module). The
special characters used in shell-style wildcards are:
diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
index 320df28f5f..3d31c116c8 100644
--- a/Doc/library/glob.rst
+++ b/Doc/library/glob.rst
@@ -9,6 +9,8 @@
**Source code:** :source:`Lib/glob.py`
+--------------
+
The :mod:`glob` module finds all the pathnames matching a specified pattern
according to the rules used by the Unix shell. No tilde expansion is done, but
``*``, ``?``, and character ranges expressed with ``[]`` will be correctly
diff --git a/Doc/library/heapq.rst b/Doc/library/heapq.rst
index f59c3b877e..c8634ba291 100644
--- a/Doc/library/heapq.rst
+++ b/Doc/library/heapq.rst
@@ -10,6 +10,8 @@
**Source code:** :source:`Lib/heapq.py`
+--------------
+
This module provides an implementation of the heap queue algorithm, also known
as the priority queue algorithm.
diff --git a/Doc/library/keyword.rst b/Doc/library/keyword.rst
index d86fef0518..173db23544 100644
--- a/Doc/library/keyword.rst
+++ b/Doc/library/keyword.rst
@@ -6,6 +6,8 @@
**Source code:** :source:`Lib/keyword.py`
+--------------
+
This module allows a Python program to determine if a string is a keyword.
diff --git a/Doc/library/linecache.rst b/Doc/library/linecache.rst
index ee965fe903..dacf8aa002 100644
--- a/Doc/library/linecache.rst
+++ b/Doc/library/linecache.rst
@@ -7,6 +7,8 @@
**Source code:** :source:`Lib/linecache.py`
+--------------
+
The :mod:`linecache` module allows one to get any line from any file, while
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
diff --git a/Doc/library/pprint.rst b/Doc/library/pprint.rst
index 58b6702fda..9ab12eea1d 100644
--- a/Doc/library/pprint.rst
+++ b/Doc/library/pprint.rst
@@ -8,6 +8,8 @@
**Source code:** :source:`Lib/pprint.py`
+--------------
+
The :mod:`pprint` module provides a capability to "pretty-print" arbitrary
Python data structures in a form which can be used as input to the interpreter.
If the formatted structures include objects which are not fundamental Python
diff --git a/Doc/library/queue.rst b/Doc/library/queue.rst
index bc3821e2eb..26336ef515 100644
--- a/Doc/library/queue.rst
+++ b/Doc/library/queue.rst
@@ -6,6 +6,8 @@
**Source code:** :source:`Lib/queue.py`
+--------------
+
The :mod:`queue` module implements multi-producer, multi-consumer queues.
It is especially useful in threaded programming when information must be
exchanged safely between multiple threads. The :class:`Queue` class in this
diff --git a/Doc/library/random.rst b/Doc/library/random.rst
index 85253123aa..f0c4add61a 100644
--- a/Doc/library/random.rst
+++ b/Doc/library/random.rst
@@ -6,6 +6,8 @@
**Source code:** :source:`Lib/random.py`
+--------------
+
This module implements pseudo-random number generators for various
distributions.
diff --git a/Doc/library/sched.rst b/Doc/library/sched.rst
index a76aacc9f8..ab58237041 100644
--- a/Doc/library/sched.rst
+++ b/Doc/library/sched.rst
@@ -9,6 +9,8 @@
**Source code:** :source:`Lib/sched.py`
+--------------
+
The :mod:`sched` module defines a class which implements a general purpose event
scheduler:
diff --git a/Doc/library/shelve.rst b/Doc/library/shelve.rst
index 499ab5181a..4b49a2f006 100644
--- a/Doc/library/shelve.rst
+++ b/Doc/library/shelve.rst
@@ -9,6 +9,8 @@
**Source code:** :source:`Lib/shelve.py`
+--------------
+
A "shelf" is a persistent, dictionary-like object. The difference with "dbm"
databases is that the values (not the keys!) in a shelf can be essentially
arbitrary Python objects --- anything that the :mod:`pickle` module can handle.
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 759dab1328..988ee4c178 100644
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -12,6 +12,8 @@
**Source code:** :source:`Lib/shutil.py`
+--------------
+
The :mod:`shutil` module offers a number of high-level operations on files and
collections of files. In particular, functions are provided which support file
copying and removal. For operations on individual files, see also the
diff --git a/Doc/library/string.rst b/Doc/library/string.rst
index 904df29d5f..32fda13d26 100644
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -13,6 +13,8 @@
**Source code:** :source:`Lib/string.py`
+--------------
+
String constants
----------------
diff --git a/Doc/library/textwrap.rst b/Doc/library/textwrap.rst
index 74e5b2ecf0..a81496206d 100644
--- a/Doc/library/textwrap.rst
+++ b/Doc/library/textwrap.rst
@@ -8,6 +8,8 @@
**Source code:** :source:`Lib/textwrap.py`
+--------------
+
The :mod:`textwrap` module provides two convenience functions, :func:`wrap` and
:func:`fill`, as well as :class:`TextWrapper`, the class that does all the work,
and a utility function :func:`dedent`. If you're just wrapping or filling one
diff --git a/Doc/library/threading.rst b/Doc/library/threading.rst
index 03ff44c597..7f0628da66 100644
--- a/Doc/library/threading.rst
+++ b/Doc/library/threading.rst
@@ -6,6 +6,8 @@
**Source code:** :source:`Lib/threading.py`
+--------------
+
This module constructs higher-level threading interfaces on top of the lower
level :mod:`_thread` module. See also the :mod:`queue` module.
diff --git a/Doc/library/tokenize.rst b/Doc/library/tokenize.rst
index 9c05439e00..577d7cca4c 100644
--- a/Doc/library/tokenize.rst
+++ b/Doc/library/tokenize.rst
@@ -8,6 +8,8 @@
**Source code:** :source:`Lib/tokenize.py`
+--------------
+
The :mod:`tokenize` module provides a lexical scanner for Python source code,
implemented in Python. The scanner in this module returns comments as tokens
as well, making it useful for implementing "pretty-printers," including
diff --git a/Doc/library/trace.rst b/Doc/library/trace.rst
index 5a32482e69..c4ddc56cf2 100644
--- a/Doc/library/trace.rst
+++ b/Doc/library/trace.rst
@@ -6,6 +6,8 @@
**Source code:** :source:`Lib/trace.py`
+--------------
+
The :mod:`trace` module allows you to trace program execution, generate
annotated statement coverage listings, print caller/callee relationships and
list functions executed during a program run. It can be used in another program
diff --git a/Doc/library/uu.rst b/Doc/library/uu.rst
index 7c1d67c6e9..d61c178831 100644
--- a/Doc/library/uu.rst
+++ b/Doc/library/uu.rst
@@ -7,6 +7,8 @@
**Source code:** :source:`Lib/uu.py`
+--------------
+
This module encodes and decodes files in uuencode format, allowing arbitrary
binary data to be transferred over ASCII-only connections. Wherever a file
argument is expected, the methods accept a file-like object. For backwards
diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst
index b147fa55be..d457095bf8 100644
--- a/Doc/whatsnew/3.2.rst
+++ b/Doc/whatsnew/3.2.rst
@@ -1614,7 +1614,7 @@ memory jog without having to read all of the docs.
In some cases, the pure Python source code can be helpful adjunct to the docs,
so now some modules feature quick links to the latest version of the source
code. For example, the :mod:`functools` module documentation has a quick link
-at the top labeled *Source code* source:`Lib/functools.py`.
+at the top labeled: *Source code* :source:`Lib/functools.py`.
The docs now contain more examples and recipes. In particular, :mod:`re` module
has an extensive section, :ref:`re-examples`. Likewise, the :mod:`itertools`