From fa089b9b0b926c04e5d57812b7d7653472787965 Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Sat, 11 Jun 2016 15:02:54 -0400 Subject: Issue #22558: Add remaining doc links to source code for Python-coded modules. Reformat header above separator line (added if missing) to a common format. Patch by Yoni Lavi. --- Doc/library/2to3.rst | 4 ++++ Doc/library/__main__.rst | 2 ++ Doc/library/_thread.rst | 3 ++- Doc/library/abc.rst | 1 + Doc/library/aifc.rst | 3 +-- Doc/library/argparse.rst | 1 + Doc/library/array.rst | 3 ++- Doc/library/asynchat.rst | 1 + Doc/library/asyncio.rst | 8 ++++---- Doc/library/asyncore.rst | 1 + Doc/library/atexit.rst | 2 ++ Doc/library/audioop.rst | 1 + Doc/library/base64.rst | 3 +++ Doc/library/binascii.rst | 3 ++- Doc/library/binhex.rst | 3 +++ Doc/library/builtins.rst | 1 + Doc/library/bz2.rst | 4 ++++ Doc/library/calendar.rst | 1 + Doc/library/cgi.rst | 3 +-- Doc/library/cgitb.rst | 4 ++++ Doc/library/chunk.rst | 4 ++++ Doc/library/cmath.rst | 1 + Doc/library/cmd.rst | 1 + Doc/library/code.rst | 2 ++ Doc/library/codecs.rst | 3 +++ Doc/library/codeop.rst | 5 +++++ Doc/library/collections.abc.rst | 5 +++-- Doc/library/collections.rst | 5 +++-- Doc/library/colorsys.rst | 1 + Doc/library/compileall.rst | 1 - Doc/library/configparser.rst | 2 ++ Doc/library/copy.rst | 4 ++++ Doc/library/copyreg.rst | 3 +++ Doc/library/crypt.rst | 4 ++++ Doc/library/csv.rst | 3 +++ Doc/library/ctypes.rst | 2 ++ Doc/library/curses.ascii.rst | 2 ++ Doc/library/curses.panel.rst | 2 ++ Doc/library/curses.rst | 3 +++ Doc/library/datetime.rst | 3 +++ Doc/library/dbm.rst | 4 ++++ Doc/library/decimal.rst | 2 ++ Doc/library/difflib.rst | 3 +++ Doc/library/distutils.rst | 2 ++ Doc/library/doctest.rst | 4 ++++ Doc/library/email.charset.rst | 3 +++ Doc/library/email.contentmanager.rst | 7 +++++-- Doc/library/email.encoders.rst | 3 +++ Doc/library/email.errors.rst | 3 +++ Doc/library/email.generator.rst | 3 +++ Doc/library/email.header.rst | 3 +++ Doc/library/email.headerregistry.rst | 7 +++++-- Doc/library/email.iterators.rst | 3 +++ Doc/library/email.message.rst | 3 +++ Doc/library/email.mime.rst | 3 +++ Doc/library/email.parser.rst | 3 +++ Doc/library/email.policy.rst | 3 +++ Doc/library/email.rst | 4 ++++ Doc/library/email.util.rst | 3 +++ Doc/library/ensurepip.rst | 2 ++ Doc/library/errno.rst | 1 + Doc/library/faulthandler.rst | 2 ++ Doc/library/fcntl.rst | 4 +++- Doc/library/filecmp.rst | 1 + Doc/library/fileinput.rst | 1 + Doc/library/fnmatch.rst | 3 +-- Doc/library/formatter.rst | 1 + Doc/library/fpectl.rst | 4 +++- Doc/library/fractions.rst | 1 + Doc/library/ftplib.rst | 3 +-- Doc/library/functools.rst | 1 + Doc/library/gc.rst | 2 ++ Doc/library/getopt.rst | 4 ++-- Doc/library/getpass.rst | 5 +++++ Doc/library/gettext.rst | 1 + Doc/library/glob.rst | 3 +-- Doc/library/grp.rst | 1 + Doc/library/hashlib.rst | 4 ++-- Doc/library/heapq.rst | 1 + Doc/library/hmac.rst | 1 + Doc/library/html.entities.rst | 1 + Doc/library/html.parser.rst | 3 +-- Doc/library/http.client.rst | 3 +-- Doc/library/http.cookiejar.rst | 1 + Doc/library/http.cookies.rst | 1 + Doc/library/http.rst | 4 +++- Doc/library/http.server.rst | 3 +-- Doc/library/idle.rst | 6 +++++- Doc/library/imaplib.rst | 4 ++-- Doc/library/imp.rst | 4 ++++ Doc/library/importlib.rst | 3 +++ Doc/library/inspect.rst | 1 + Doc/library/io.rst | 5 +++++ Doc/library/ipaddress.rst | 1 + Doc/library/itertools.rst | 3 ++- Doc/library/json.rst | 5 +++++ Doc/library/linecache.rst | 1 + Doc/library/locale.rst | 4 ++++ Doc/library/logging.config.rst | 5 ++--- Doc/library/logging.handlers.rst | 5 ++--- Doc/library/logging.rst | 5 +---- Doc/library/lzma.rst | 4 ++++ Doc/library/macpath.rst | 3 +++ Doc/library/mailbox.rst | 4 ++++ Doc/library/marshal.rst | 1 + Doc/library/math.rst | 2 ++ Doc/library/mimetypes.rst | 4 ++-- Doc/library/mmap.rst | 1 + Doc/library/modulefinder.rst | 5 ++--- Doc/library/msilib.rst | 4 ++++ Doc/library/msvcrt.rst | 2 ++ Doc/library/multiprocessing.rst | 3 +++ Doc/library/netrc.rst | 1 + Doc/library/nis.rst | 2 ++ Doc/library/nntplib.rst | 3 +-- Doc/library/numbers.rst | 3 +++ Doc/library/operator.rst | 4 ++-- Doc/library/optparse.rst | 5 +++-- Doc/library/os.path.rst | 6 ++++++ Doc/library/os.rst | 3 +++ Doc/library/ossaudiodev.rst | 1 + Doc/library/parser.rst | 4 +++- Doc/library/pathlib.rst | 6 +++++- Doc/library/pdb.rst | 4 ++-- Doc/library/pickle.rst | 14 +++++++++----- Doc/library/pipes.rst | 1 + Doc/library/platform.rst | 1 + Doc/library/plistlib.rst | 5 +++-- Doc/library/poplib.rst | 5 +++-- Doc/library/posix.rst | 1 + Doc/library/pprint.rst | 1 + Doc/library/pty.rst | 4 ++++ Doc/library/pwd.rst | 1 + Doc/library/py_compile.rst | 5 +++-- Doc/library/pyclbr.rst | 1 + Doc/library/pydoc.rst | 4 ++-- Doc/library/pyexpat.rst | 2 ++ Doc/library/quopri.rst | 3 +-- Doc/library/re.rst | 4 ++++ Doc/library/readline.rst | 2 ++ Doc/library/reprlib.rst | 1 + Doc/library/resource.rst | 2 ++ Doc/library/rlcompleter.rst | 1 + Doc/library/runpy.rst | 1 + Doc/library/sched.rst | 5 +++-- Doc/library/select.rst | 1 + Doc/library/selectors.rst | 3 +++ Doc/library/shelve.rst | 3 +-- Doc/library/shlex.rst | 1 + Doc/library/shutil.rst | 5 +++-- Doc/library/signal.rst | 1 + Doc/library/smtplib.rst | 4 ++-- Doc/library/sndhdr.rst | 5 +++-- Doc/library/socket.rst | 3 +++ Doc/library/spwd.rst | 1 + Doc/library/sqlite3.rst | 4 ++++ Doc/library/ssl.rst | 3 +-- Doc/library/stat.rst | 4 ++-- Doc/library/statistics.rst | 5 +++-- Doc/library/stringprep.rst | 4 ++++ Doc/library/struct.rst | 4 ++++ Doc/library/subprocess.rst | 4 ++++ Doc/library/sunau.rst | 1 + Doc/library/symbol.rst | 1 + Doc/library/sys.rst | 1 + Doc/library/sysconfig.rst | 7 ++++--- Doc/library/syslog.rst | 1 + Doc/library/tabnanny.rst | 1 + Doc/library/tarfile.rst | 1 - Doc/library/telnetlib.rst | 4 ++-- Doc/library/tempfile.rst | 8 +++----- Doc/library/termios.rst | 3 ++- Doc/library/test.rst | 2 ++ Doc/library/textwrap.rst | 1 + Doc/library/time.rst | 1 + Doc/library/timeit.rst | 3 +-- Doc/library/tkinter.rst | 4 ++++ Doc/library/tkinter.scrolledtext.rst | 4 ++++ Doc/library/tkinter.tix.rst | 4 ++++ Doc/library/tkinter.ttk.rst | 4 ++++ Doc/library/token.rst | 1 + Doc/library/tokenize.rst | 1 + Doc/library/traceback.rst | 3 +++ Doc/library/tracemalloc.rst | 4 ++++ Doc/library/tty.rst | 4 ++++ Doc/library/turtle.rst | 5 +++++ Doc/library/typing.rst | 4 ++-- Doc/library/unicodedata.rst | 4 +++- Doc/library/unittest.mock.rst | 7 +++++-- Doc/library/unittest.rst | 5 +++++ Doc/library/urllib.error.rst | 4 ++++ Doc/library/urllib.parse.rst | 3 +-- Doc/library/urllib.request.rst | 4 ++++ Doc/library/urllib.robotparser.rst | 4 ++++ Doc/library/urllib.rst | 4 ++++ Doc/library/uu.rst | 1 + Doc/library/uuid.rst | 3 +++ Doc/library/venv.rst | 8 ++++---- Doc/library/warnings.rst | 4 ++-- Doc/library/wave.rst | 1 + Doc/library/weakref.rst | 1 + Doc/library/webbrowser.rst | 1 + Doc/library/winreg.rst | 2 ++ Doc/library/winsound.rst | 2 ++ Doc/library/wsgiref.rst | 2 ++ Doc/library/xdrlib.rst | 3 +-- Doc/library/xml.dom.minidom.rst | 1 + Doc/library/xml.dom.pulldom.rst | 1 + Doc/library/xml.dom.rst | 4 ++++ Doc/library/xml.etree.elementtree.rst | 5 +++++ Doc/library/xml.rst | 4 ++++ Doc/library/xml.sax.handler.rst | 4 ++++ Doc/library/xml.sax.reader.rst | 4 ++++ Doc/library/xml.sax.rst | 4 ++++ Doc/library/xml.sax.utils.rst | 4 ++++ Doc/library/xmlrpc.client.rst | 4 ++-- Doc/library/xmlrpc.server.rst | 1 + Doc/library/zipapp.rst | 7 +++---- Doc/library/zipfile.rst | 1 + Doc/library/zipimport.rst | 2 ++ Doc/library/zlib.rst | 1 + Lib/idlelib/help.html | 6 ++++-- Misc/ACKS | 1 + Misc/NEWS | 3 +++ 224 files changed, 539 insertions(+), 136 deletions(-) diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst index 15b72dd..6fc2865 100644 --- a/Doc/library/2to3.rst +++ b/Doc/library/2to3.rst @@ -449,10 +449,14 @@ and off individually. They are described here in more detail. .. module:: lib2to3 :synopsis: the 2to3 library + .. moduleauthor:: Guido van Rossum .. moduleauthor:: Collin Winter .. moduleauthor:: Benjamin Peterson +**Source code:** :source:`Lib/lib2to3/` + +-------------- .. note:: diff --git a/Doc/library/__main__.rst b/Doc/library/__main__.rst index a46993d..a64faf1 100644 --- a/Doc/library/__main__.rst +++ b/Doc/library/__main__.rst @@ -5,6 +5,8 @@ .. module:: __main__ :synopsis: The environment where the top-level script is run. +-------------- + ``'__main__'`` is the name of the scope in which top-level code executes. A module's __name__ is set equal to ``'__main__'`` when read from standard input, a script, or from an interactive prompt. diff --git a/Doc/library/_thread.rst b/Doc/library/_thread.rst index 7122861..0d2d818 100644 --- a/Doc/library/_thread.rst +++ b/Doc/library/_thread.rst @@ -4,13 +4,14 @@ .. module:: _thread :synopsis: Low-level threading API. - .. index:: single: light-weight processes single: processes, light-weight single: binary semaphores single: semaphores, binary +-------------- + This module provides low-level primitives for working with multiple threads (also called :dfn:`light-weight processes` or :dfn:`tasks`) --- multiple threads of control sharing their global data space. For synchronization, simple locks diff --git a/Doc/library/abc.rst b/Doc/library/abc.rst index 7a73704..966003b 100644 --- a/Doc/library/abc.rst +++ b/Doc/library/abc.rst @@ -3,6 +3,7 @@ .. module:: abc :synopsis: Abstract base classes according to PEP 3119. + .. moduleauthor:: Guido van Rossum .. sectionauthor:: Georg Brandl .. much of the content adapted from docstrings diff --git a/Doc/library/aifc.rst b/Doc/library/aifc.rst index 6fbcf28..23a9620 100644 --- a/Doc/library/aifc.rst +++ b/Doc/library/aifc.rst @@ -4,14 +4,13 @@ .. module:: aifc :synopsis: Read and write audio files in AIFF or AIFC format. +**Source code:** :source:`Lib/aifc.py` .. index:: single: Audio Interchange File Format single: AIFF single: AIFF-C -**Source code:** :source:`Lib/aifc.py` - -------------- This module provides support for reading and writing AIFF and AIFF-C files. diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst index 6a7f8ef..10789e9 100644 --- a/Doc/library/argparse.rst +++ b/Doc/library/argparse.rst @@ -3,6 +3,7 @@ .. module:: argparse :synopsis: Command-line option and argument parsing library. + .. moduleauthor:: Steven Bethard .. sectionauthor:: Steven Bethard diff --git a/Doc/library/array.rst b/Doc/library/array.rst index 00406e0..24f3f62 100644 --- a/Doc/library/array.rst +++ b/Doc/library/array.rst @@ -4,9 +4,10 @@ .. module:: array :synopsis: Space efficient arrays of uniformly typed numeric values. - .. index:: single: arrays +-------------- + This module defines an object type which can compactly represent an array of basic values: characters, integers, floating point numbers. Arrays are sequence types and behave very much like lists, except that the type of objects stored in diff --git a/Doc/library/asynchat.rst b/Doc/library/asynchat.rst index 56ad4f8..ae72d26 100644 --- a/Doc/library/asynchat.rst +++ b/Doc/library/asynchat.rst @@ -3,6 +3,7 @@ .. module:: asynchat :synopsis: Support for asynchronous command/response protocols. + .. moduleauthor:: Sam Rushing .. sectionauthor:: Steve Holden diff --git a/Doc/library/asyncio.rst b/Doc/library/asyncio.rst index 9b4d65e..f764c68 100644 --- a/Doc/library/asyncio.rst +++ b/Doc/library/asyncio.rst @@ -4,6 +4,10 @@ .. module:: asyncio :synopsis: Asynchronous I/O, event loop, coroutines and tasks. +.. versionadded:: 3.4 + +**Source code:** :source:`Lib/asyncio/` + .. note:: The asyncio package has been included in the standard library on a @@ -11,10 +15,6 @@ changes (up to and including removal of the module) may occur if deemed necessary by the core developers. -.. versionadded:: 3.4 - -**Source code:** :source:`Lib/asyncio/` - -------------- This module provides infrastructure for writing single-threaded concurrent diff --git a/Doc/library/asyncore.rst b/Doc/library/asyncore.rst index 02ae72a..61061be 100644 --- a/Doc/library/asyncore.rst +++ b/Doc/library/asyncore.rst @@ -4,6 +4,7 @@ .. module:: asyncore :synopsis: A base class for developing asynchronous socket handling services. + .. moduleauthor:: Sam Rushing .. sectionauthor:: Christopher Petrilli .. sectionauthor:: Steve Holden diff --git a/Doc/library/atexit.rst b/Doc/library/atexit.rst index dbdd81e..1d84d45 100644 --- a/Doc/library/atexit.rst +++ b/Doc/library/atexit.rst @@ -3,9 +3,11 @@ .. module:: atexit :synopsis: Register and execute cleanup functions. + .. moduleauthor:: Skip Montanaro .. sectionauthor:: Skip Montanaro +-------------- The :mod:`atexit` module defines functions to register and unregister cleanup functions. Functions thus registered are automatically executed upon normal diff --git a/Doc/library/audioop.rst b/Doc/library/audioop.rst index 08d5f81..bad9da2 100644 --- a/Doc/library/audioop.rst +++ b/Doc/library/audioop.rst @@ -4,6 +4,7 @@ .. module:: audioop :synopsis: Manipulate raw audio data. +-------------- The :mod:`audioop` module contains some useful operations on sound fragments. It operates on sound fragments consisting of signed integer samples 8, 16, 24 diff --git a/Doc/library/base64.rst b/Doc/library/base64.rst index 4b28b4e..080d9d7 100644 --- a/Doc/library/base64.rst +++ b/Doc/library/base64.rst @@ -5,11 +5,14 @@ :synopsis: RFC 3548: Base16, Base32, Base64 Data Encodings; Base85 and Ascii85 +**Source code:** :source:`Lib/base64.py` .. index:: pair: base64; encoding single: MIME; base64 encoding +-------------- + This module provides functions for encoding binary data to printable ASCII characters and decoding such encodings back to binary data. It provides encoding and decoding functions for the encodings specified in diff --git a/Doc/library/binascii.rst b/Doc/library/binascii.rst index 1752c63..878d8db 100644 --- a/Doc/library/binascii.rst +++ b/Doc/library/binascii.rst @@ -5,12 +5,13 @@ :synopsis: Tools for converting between binary and various ASCII-encoded binary representations. - .. index:: module: uu module: base64 module: binhex +-------------- + The :mod:`binascii` module contains a number of methods to convert between binary and various ASCII-encoded binary representations. Normally, you will not use these functions directly but use wrapper modules like :mod:`uu`, diff --git a/Doc/library/binhex.rst b/Doc/library/binhex.rst index 43c7823..359ab23 100644 --- a/Doc/library/binhex.rst +++ b/Doc/library/binhex.rst @@ -4,6 +4,9 @@ .. module:: binhex :synopsis: Encode and decode files in binhex4 format. +**Source code:** :source:`Lib/binhex.py` + +-------------- This module encodes and decodes files in binhex4 format, a format allowing representation of Macintosh files in ASCII. Only the data fork is handled. diff --git a/Doc/library/builtins.rst b/Doc/library/builtins.rst index 2cca1d0..4b589a5 100644 --- a/Doc/library/builtins.rst +++ b/Doc/library/builtins.rst @@ -4,6 +4,7 @@ .. module:: builtins :synopsis: The module that provides the built-in namespace. +-------------- This module provides direct access to all 'built-in' identifiers of Python; for example, ``builtins.open`` is the full name for the built-in function diff --git a/Doc/library/bz2.rst b/Doc/library/bz2.rst index 1b8d9cf..6c49d9f 100644 --- a/Doc/library/bz2.rst +++ b/Doc/library/bz2.rst @@ -3,11 +3,15 @@ .. module:: bz2 :synopsis: Interfaces for bzip2 compression and decompression. + .. moduleauthor:: Gustavo Niemeyer .. moduleauthor:: Nadeem Vawda .. sectionauthor:: Gustavo Niemeyer .. sectionauthor:: Nadeem Vawda +**Source code:** :source:`Lib/bz2.py` + +-------------- This module provides a comprehensive interface for compressing and decompressing data using the bzip2 compression algorithm. diff --git a/Doc/library/calendar.rst b/Doc/library/calendar.rst index 3187c43..df76e33 100644 --- a/Doc/library/calendar.rst +++ b/Doc/library/calendar.rst @@ -4,6 +4,7 @@ .. module:: calendar :synopsis: Functions for working with calendars, including some emulation of the Unix cal program. + .. sectionauthor:: Drew Csillag **Source code:** :source:`Lib/calendar.py` diff --git a/Doc/library/cgi.rst b/Doc/library/cgi.rst index 7e496ca..0bc2c35 100644 --- a/Doc/library/cgi.rst +++ b/Doc/library/cgi.rst @@ -4,6 +4,7 @@ .. module:: cgi :synopsis: Helpers for running Python scripts via the Common Gateway Interface. +**Source code:** :source:`Lib/cgi.py` .. index:: pair: WWW; server @@ -13,8 +14,6 @@ single: URL single: Common Gateway Interface -**Source code:** :source:`Lib/cgi.py` - -------------- Support module for Common Gateway Interface (CGI) scripts. diff --git a/Doc/library/cgitb.rst b/Doc/library/cgitb.rst index 6827c8e..b65a635 100644 --- a/Doc/library/cgitb.rst +++ b/Doc/library/cgitb.rst @@ -3,9 +3,11 @@ .. module:: cgitb :synopsis: Configurable traceback handler for CGI scripts. + .. moduleauthor:: Ka-Ping Yee .. sectionauthor:: Fred L. Drake, Jr. +**Source code:** :source:`Lib/cgitb.py` .. index:: single: CGI; exceptions @@ -13,6 +15,8 @@ single: exceptions; in CGI scripts single: tracebacks; in CGI scripts +-------------- + The :mod:`cgitb` module provides a special exception handler for Python scripts. (Its name is a bit misleading. It was originally designed to display extensive traceback information in HTML for CGI scripts. It was later generalized to also diff --git a/Doc/library/chunk.rst b/Doc/library/chunk.rst index a90e9f8..5e24df9 100644 --- a/Doc/library/chunk.rst +++ b/Doc/library/chunk.rst @@ -3,9 +3,11 @@ .. module:: chunk :synopsis: Module to read IFF chunks. + .. moduleauthor:: Sjoerd Mullender .. sectionauthor:: Sjoerd Mullender +**Source code:** :source:`Lib/chunk.py` .. index:: single: Audio Interchange File Format @@ -14,6 +16,8 @@ single: Real Media File Format single: RMFF +-------------- + This module provides an interface for reading files that use EA IFF 85 chunks. [#]_ This format is used in at least the Audio Interchange File Format (AIFF/AIFF-C) and the Real Media File Format (RMFF). The WAVE audio file format diff --git a/Doc/library/cmath.rst b/Doc/library/cmath.rst index ab619a0..62ddb6b 100644 --- a/Doc/library/cmath.rst +++ b/Doc/library/cmath.rst @@ -4,6 +4,7 @@ .. module:: cmath :synopsis: Mathematical functions for complex numbers. +-------------- This module is always available. It provides access to mathematical functions for complex numbers. The functions in this module accept integers, diff --git a/Doc/library/cmd.rst b/Doc/library/cmd.rst index 1ab2d74..61ef0f6 100644 --- a/Doc/library/cmd.rst +++ b/Doc/library/cmd.rst @@ -3,6 +3,7 @@ .. module:: cmd :synopsis: Build line-oriented command interpreters. + .. sectionauthor:: Eric S. Raymond **Source code:** :source:`Lib/cmd.py` diff --git a/Doc/library/code.rst b/Doc/library/code.rst index 275201c..443af69 100644 --- a/Doc/library/code.rst +++ b/Doc/library/code.rst @@ -6,6 +6,8 @@ **Source code:** :source:`Lib/code.py` +-------------- + The ``code`` module provides facilities to implement read-eval-print loops in Python. Two classes and convenience functions are included which can be used to build applications which provide an interactive interpreter prompt. diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst index a2530de..1add300 100644 --- a/Doc/library/codecs.rst +++ b/Doc/library/codecs.rst @@ -3,6 +3,7 @@ .. module:: codecs :synopsis: Encode and decode data and streams. + .. moduleauthor:: Marc-André Lemburg .. sectionauthor:: Marc-André Lemburg .. sectionauthor:: Martin v. Löwis @@ -17,6 +18,8 @@ single: streams pair: stackable; streams +-------------- + This module defines base classes for standard Python codecs (encoders and decoders) and provides access to the internal Python codec registry, which manages the codec and error handling lookup process. Most standard codecs diff --git a/Doc/library/codeop.rst b/Doc/library/codeop.rst index 9ae4176..a52d2c6 100644 --- a/Doc/library/codeop.rst +++ b/Doc/library/codeop.rst @@ -3,9 +3,14 @@ .. module:: codeop :synopsis: Compile (possibly incomplete) Python code. + .. sectionauthor:: Moshe Zadka .. sectionauthor:: Michael Hudson +**Source code:** :source:`Lib/codeop.py` + +-------------- + The :mod:`codeop` module provides utilities upon which the Python read-eval-print loop can be emulated, as is done in the :mod:`code` module. As a result, you probably don't want to use the module directly; if you want to diff --git a/Doc/library/collections.abc.rst b/Doc/library/collections.abc.rst index e76ca78..61682cc 100644 --- a/Doc/library/collections.abc.rst +++ b/Doc/library/collections.abc.rst @@ -3,20 +3,21 @@ .. module:: collections.abc :synopsis: Abstract base classes for containers + .. moduleauthor:: Raymond Hettinger .. sectionauthor:: Raymond Hettinger .. versionadded:: 3.3 Formerly, this module was part of the :mod:`collections` module. +**Source code:** :source:`Lib/_collections_abc.py` + .. testsetup:: * from collections import * import itertools __name__ = '' -**Source code:** :source:`Lib/_collections_abc.py` - -------------- This module provides :term:`abstract base classes ` that diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index b8f0621..4936b3a 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -3,17 +3,18 @@ .. module:: collections :synopsis: Container datatypes + .. moduleauthor:: Raymond Hettinger .. sectionauthor:: Raymond Hettinger +**Source code:** :source:`Lib/collections/__init__.py` + .. testsetup:: * from collections import * import itertools __name__ = '' -**Source code:** :source:`Lib/collections/__init__.py` - -------------- This module implements specialized container datatypes providing alternatives to diff --git a/Doc/library/colorsys.rst b/Doc/library/colorsys.rst index f1447e8..c33f531 100644 --- a/Doc/library/colorsys.rst +++ b/Doc/library/colorsys.rst @@ -3,6 +3,7 @@ .. module:: colorsys :synopsis: Conversion functions between RGB and other color systems. + .. sectionauthor:: David Ascher **Source code:** :source:`Lib/colorsys.py` diff --git a/Doc/library/compileall.rst b/Doc/library/compileall.rst index c5736f2..511c581 100644 --- a/Doc/library/compileall.rst +++ b/Doc/library/compileall.rst @@ -8,7 +8,6 @@ -------------- - This module provides some utility functions to support installing Python libraries. These functions compile Python source files in a directory tree. This module can be used to create the cached byte-code files at library diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst index c5dc8d7..eeae96a 100644 --- a/Doc/library/configparser.rst +++ b/Doc/library/configparser.rst @@ -19,6 +19,8 @@ single: ini file single: Windows ini file +-------------- + This module provides the :class:`ConfigParser` class which implements a basic configuration language which provides a structure similar to what's found in Microsoft Windows INI files. You can use this to write Python programs which diff --git a/Doc/library/copy.rst b/Doc/library/copy.rst index 02ef0e5..a8adcad 100644 --- a/Doc/library/copy.rst +++ b/Doc/library/copy.rst @@ -4,6 +4,10 @@ .. module:: copy :synopsis: Shallow and deep copy operations. +**Source code:** :source:`Lib/copy.py` + +-------------- + Assignment statements in Python do not copy objects, they create bindings between a target and an object. For collections that are mutable or contain mutable items, a copy is sometimes needed so one can change one copy without diff --git a/Doc/library/copyreg.rst b/Doc/library/copyreg.rst index 18306c7..eeabb4c 100644 --- a/Doc/library/copyreg.rst +++ b/Doc/library/copyreg.rst @@ -4,11 +4,14 @@ .. module:: copyreg :synopsis: Register pickle support functions. +**Source code:** :source:`Lib/copyreg.py` .. index:: module: pickle module: copy +-------------- + The :mod:`copyreg` module offers a way to define functions used while pickling specific objects. The :mod:`pickle` and :mod:`copy` modules use those functions when pickling/copying those objects. The module provides configuration diff --git a/Doc/library/crypt.rst b/Doc/library/crypt.rst index 0661426..a21c1e7 100644 --- a/Doc/library/crypt.rst +++ b/Doc/library/crypt.rst @@ -4,15 +4,19 @@ .. module:: crypt :platform: Unix :synopsis: The crypt() function used to check Unix passwords. + .. moduleauthor:: Steven D. Majewski .. sectionauthor:: Steven D. Majewski .. sectionauthor:: Peter Funk +**Source code:** :source:`Lib/crypt.py` .. index:: single: crypt(3) pair: cipher; DES +-------------- + This module implements an interface to the :manpage:`crypt(3)` routine, which is a one-way hash function based upon a modified DES algorithm; see the Unix man page for further details. Possible uses include storing hashed passwords diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst index 4fcfaef..7fb4fc8 100644 --- a/Doc/library/csv.rst +++ b/Doc/library/csv.rst @@ -3,6 +3,7 @@ .. module:: csv :synopsis: Write and read tabular data to and from delimited files. + .. sectionauthor:: Skip Montanaro **Source code:** :source:`Lib/csv.py` @@ -11,6 +12,8 @@ single: csv pair: data; tabular +-------------- + The so-called CSV (Comma Separated Values) format is the most common import and export format for spreadsheets and databases. CSV format was used for many years prior to attempts to describe the format in a standardized way in diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst index 508ffc3..a675790 100644 --- a/Doc/library/ctypes.rst +++ b/Doc/library/ctypes.rst @@ -3,8 +3,10 @@ .. module:: ctypes :synopsis: A foreign function library for Python. + .. moduleauthor:: Thomas Heller +-------------- :mod:`ctypes` is a foreign function library for Python. It provides C compatible data types, and allows calling functions in DLLs or shared libraries. It can be diff --git a/Doc/library/curses.ascii.rst b/Doc/library/curses.ascii.rst index 6bc1fb9..f3661d9 100644 --- a/Doc/library/curses.ascii.rst +++ b/Doc/library/curses.ascii.rst @@ -3,9 +3,11 @@ .. module:: curses.ascii :synopsis: Constants and set-membership functions for ASCII characters. + .. moduleauthor:: Eric S. Raymond .. sectionauthor:: Eric S. Raymond +-------------- The :mod:`curses.ascii` module supplies name constants for ASCII characters and functions to test membership in various ASCII character classes. The constants diff --git a/Doc/library/curses.panel.rst b/Doc/library/curses.panel.rst index a3c8bda..c99c37a 100644 --- a/Doc/library/curses.panel.rst +++ b/Doc/library/curses.panel.rst @@ -3,8 +3,10 @@ .. module:: curses.panel :synopsis: A panel stack extension that adds depth to curses windows. + .. sectionauthor:: A.M. Kuchling +-------------- Panels are windows with the added feature of depth, so they can be stacked on top of each other, and only the visible portions of each window will be diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst index 144f7f8..b12a325 100644 --- a/Doc/library/curses.rst +++ b/Doc/library/curses.rst @@ -5,9 +5,12 @@ :synopsis: An interface to the curses library, providing portable terminal handling. :platform: Unix + .. sectionauthor:: Moshe Zadka .. sectionauthor:: Eric Raymond +-------------- + The :mod:`curses` module provides an interface to the curses library, the de-facto standard for portable advanced terminal handling. diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index 3c60819..9254ae8 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -3,12 +3,15 @@ .. module:: datetime :synopsis: Basic date and time types. + .. moduleauthor:: Tim Peters .. sectionauthor:: Tim Peters .. sectionauthor:: A.M. Kuchling **Source code:** :source:`Lib/datetime.py` +-------------- + .. XXX what order should the types be discussed in? The :mod:`datetime` module supplies classes for manipulating dates and times in diff --git a/Doc/library/dbm.rst b/Doc/library/dbm.rst index 5df9eab..6f64196 100644 --- a/Doc/library/dbm.rst +++ b/Doc/library/dbm.rst @@ -4,6 +4,10 @@ .. module:: dbm :synopsis: Interfaces to various Unix "database" formats. +**Source code:** :source:`Lib/dbm/__init__.py` + +-------------- + :mod:`dbm` is a generic interface to variants of the DBM database --- :mod:`dbm.gnu` or :mod:`dbm.ndbm`. If none of these modules is installed, the slow-but-simple implementation in module :mod:`dbm.dumb` will be used. There diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst index d46f850..528f97b 100644 --- a/Doc/library/decimal.rst +++ b/Doc/library/decimal.rst @@ -23,6 +23,8 @@ # make sure each group gets a fresh context setcontext(Context()) +-------------- + The :mod:`decimal` module provides support for fast correctly-rounded decimal floating point arithmetic. It offers several advantages over the :class:`float` datatype: diff --git a/Doc/library/difflib.rst b/Doc/library/difflib.rst index f161e2f..59a6478 100644 --- a/Doc/library/difflib.rst +++ b/Doc/library/difflib.rst @@ -3,6 +3,7 @@ .. module:: difflib :synopsis: Helpers for computing differences between objects. + .. moduleauthor:: Tim Peters .. sectionauthor:: Tim Peters .. Markup by Fred L. Drake, Jr. @@ -14,6 +15,8 @@ import sys from difflib import * +-------------- + This module provides classes and functions for comparing sequences. It can be used for example, for comparing files, and can produce difference information in various formats, including HTML and context and unified diff --git a/Doc/library/distutils.rst b/Doc/library/distutils.rst index 12ad8c0..62abc85 100644 --- a/Doc/library/distutils.rst +++ b/Doc/library/distutils.rst @@ -4,8 +4,10 @@ .. module:: distutils :synopsis: Support for building and installing Python modules into an existing Python installation. + .. sectionauthor:: Fred L. Drake, Jr. +-------------- The :mod:`distutils` package provides support for building and installing additional modules into a Python installation. The new modules may be either diff --git a/Doc/library/doctest.rst b/Doc/library/doctest.rst index 9f7d12c..c58f417 100644 --- a/Doc/library/doctest.rst +++ b/Doc/library/doctest.rst @@ -5,11 +5,15 @@ .. module:: doctest :synopsis: Test pieces of code within docstrings. + .. moduleauthor:: Tim Peters .. sectionauthor:: Tim Peters .. sectionauthor:: Moshe Zadka .. sectionauthor:: Edward Loper +**Source code:** :source:`Lib/doctest.py` + +-------------- The :mod:`doctest` module searches for pieces of text that look like interactive Python sessions, and then executes those sessions to verify that they work diff --git a/Doc/library/email.charset.rst b/Doc/library/email.charset.rst index c0fab8f..161d86a 100644 --- a/Doc/library/email.charset.rst +++ b/Doc/library/email.charset.rst @@ -4,6 +4,9 @@ .. module:: email.charset :synopsis: Character Sets +**Source code:** :source:`Lib/email/charset.py` + +-------------- This module provides a class :class:`Charset` for representing character sets and character set conversions in email messages, as well as a character set diff --git a/Doc/library/email.contentmanager.rst b/Doc/library/email.contentmanager.rst index f53d34b..cd63728 100644 --- a/Doc/library/email.contentmanager.rst +++ b/Doc/library/email.contentmanager.rst @@ -7,6 +7,10 @@ .. moduleauthor:: R. David Murray .. sectionauthor:: R. David Murray +.. versionadded:: 3.4 + as a :term:`provisional module `. + +**Source code:** :source:`Lib/email/contentmanager.py` .. note:: @@ -15,8 +19,7 @@ changes (up to and including removal of the module) may occur if deemed necessary by the core developers. -.. versionadded:: 3.4 - as a :term:`provisional module `. +-------------- The :mod:`~email.message` module provides a class that can represent an arbitrary email message. That basic message model has a useful and flexible diff --git a/Doc/library/email.encoders.rst b/Doc/library/email.encoders.rst index 916ba5d..9d7f9bf 100644 --- a/Doc/library/email.encoders.rst +++ b/Doc/library/email.encoders.rst @@ -4,6 +4,9 @@ .. module:: email.encoders :synopsis: Encoders for email message payloads. +**Source code:** :source:`Lib/email/encoders.py` + +-------------- When creating :class:`~email.message.Message` objects from scratch, you often need to encode the payloads for transport through compliant mail servers. This diff --git a/Doc/library/email.errors.rst b/Doc/library/email.errors.rst index 294e3ed..8470783 100644 --- a/Doc/library/email.errors.rst +++ b/Doc/library/email.errors.rst @@ -4,6 +4,9 @@ .. module:: email.errors :synopsis: The exception classes used by the email package. +**Source code:** :source:`Lib/email/errors.py` + +-------------- The following exception classes are defined in the :mod:`email.errors` module: diff --git a/Doc/library/email.generator.rst b/Doc/library/email.generator.rst index 3ed6e3b..d596ed8 100644 --- a/Doc/library/email.generator.rst +++ b/Doc/library/email.generator.rst @@ -4,6 +4,9 @@ .. module:: email.generator :synopsis: Generate flat text email messages from a message structure. +**Source code:** :source:`Lib/email/generator.py` + +-------------- One of the most common tasks is to generate the flat text of the email message represented by a message object structure. You will need to do this if you want diff --git a/Doc/library/email.header.rst b/Doc/library/email.header.rst index 346d23f..e94837c 100644 --- a/Doc/library/email.header.rst +++ b/Doc/library/email.header.rst @@ -4,6 +4,9 @@ .. module:: email.header :synopsis: Representing non-ASCII headers +**Source code:** :source:`Lib/email/header.py` + +-------------- :rfc:`2822` is the base standard that describes the format of email messages. It derives from the older :rfc:`822` standard which came into widespread use at diff --git a/Doc/library/email.headerregistry.rst b/Doc/library/email.headerregistry.rst index 4af083f..0707bd8 100644 --- a/Doc/library/email.headerregistry.rst +++ b/Doc/library/email.headerregistry.rst @@ -7,6 +7,10 @@ .. moduleauthor:: R. David Murray .. sectionauthor:: R. David Murray +.. versionadded:: 3.3 + as a :term:`provisional module `. + +**Source code:** :source:`Lib/email/headerregistry.py` .. note:: @@ -15,8 +19,7 @@ changes (up to and including removal of the module) may occur if deemed necessary by the core developers. -.. versionadded:: 3.3 - as a :term:`provisional module `. +-------------- Headers are represented by customized subclasses of :class:`str`. The particular class used to represent a given header is determined by the diff --git a/Doc/library/email.iterators.rst b/Doc/library/email.iterators.rst index f92f460..f3e9e18 100644 --- a/Doc/library/email.iterators.rst +++ b/Doc/library/email.iterators.rst @@ -4,6 +4,9 @@ .. module:: email.iterators :synopsis: Iterate over a message object tree. +**Source code:** :source:`Lib/email/iterators.py` + +-------------- Iterating over a message object tree is fairly easy with the :meth:`Message.walk ` method. The diff --git a/Doc/library/email.message.rst b/Doc/library/email.message.rst index b91f26d..91a694f 100644 --- a/Doc/library/email.message.rst +++ b/Doc/library/email.message.rst @@ -4,6 +4,9 @@ .. module:: email.message :synopsis: The base class representing email messages. +**Source code:** :source:`Lib/email/message.py` + +-------------- The central class in the :mod:`email` package is the :class:`Message` class, imported from the :mod:`email.message` module. It is the base class for the diff --git a/Doc/library/email.mime.rst b/Doc/library/email.mime.rst index 67d0a67..8297dea 100644 --- a/Doc/library/email.mime.rst +++ b/Doc/library/email.mime.rst @@ -4,6 +4,9 @@ .. module:: email.mime :synopsis: Build MIME messages. +**Source code:** :source:`Lib/email/mime/` + +-------------- Ordinarily, you get a message object structure by passing a file or some text to a parser, which parses the text and returns the root message object. However diff --git a/Doc/library/email.parser.rst b/Doc/library/email.parser.rst index 177adc6..93c09ad 100644 --- a/Doc/library/email.parser.rst +++ b/Doc/library/email.parser.rst @@ -4,6 +4,9 @@ .. module:: email.parser :synopsis: Parse flat text email messages to produce a message object structure. +**Source code:** :source:`Lib/email/parser.py` + +-------------- Message object structures can be created in one of two ways: they can be created from whole cloth by instantiating :class:`~email.message.Message` objects and diff --git a/Doc/library/email.policy.rst b/Doc/library/email.policy.rst index 045b119..47f3212 100644 --- a/Doc/library/email.policy.rst +++ b/Doc/library/email.policy.rst @@ -9,6 +9,9 @@ .. versionadded:: 3.3 +**Source code:** :source:`Lib/email/policy.py` + +-------------- The :mod:`email` package's prime focus is the handling of email messages as described by the various email and MIME RFCs. However, the general format of diff --git a/Doc/library/email.rst b/Doc/library/email.rst index 95c0a2f..e8bb02b 100644 --- a/Doc/library/email.rst +++ b/Doc/library/email.rst @@ -4,10 +4,14 @@ .. module:: email :synopsis: Package supporting the parsing, manipulating, and generating email messages, including MIME documents. + .. moduleauthor:: Barry A. Warsaw .. sectionauthor:: Barry A. Warsaw .. Copyright (C) 2001-2010 Python Software Foundation +**Source code:** :source:`Lib/email/__init__.py` + +-------------- The :mod:`email` package is a library for managing email messages, including MIME and other :rfc:`2822`\ -based message documents. It is specifically *not* diff --git a/Doc/library/email.util.rst b/Doc/library/email.util.rst index 219e284..5cff746 100644 --- a/Doc/library/email.util.rst +++ b/Doc/library/email.util.rst @@ -4,6 +4,9 @@ .. module:: email.utils :synopsis: Miscellaneous email package utilities. +**Source code:** :source:`Lib/email/utils.py` + +-------------- There are several useful utilities provided in the :mod:`email.utils` module: diff --git a/Doc/library/ensurepip.rst b/Doc/library/ensurepip.rst index d589f1c..6aeeabc 100644 --- a/Doc/library/ensurepip.rst +++ b/Doc/library/ensurepip.rst @@ -7,6 +7,8 @@ .. versionadded:: 3.4 +-------------- + The :mod:`ensurepip` package provides support for bootstrapping the ``pip`` installer into an existing Python installation or virtual environment. This bootstrapping approach reflects the fact that ``pip`` is an independent diff --git a/Doc/library/errno.rst b/Doc/library/errno.rst index 22a5cbc..1cbd51c 100644 --- a/Doc/library/errno.rst +++ b/Doc/library/errno.rst @@ -4,6 +4,7 @@ .. module:: errno :synopsis: Standard errno system symbols. +---------------- This module makes available standard ``errno`` system symbols. The value of each symbol is the corresponding integer value. The names and descriptions are diff --git a/Doc/library/faulthandler.rst b/Doc/library/faulthandler.rst index 3a5badd..deedea1 100644 --- a/Doc/library/faulthandler.rst +++ b/Doc/library/faulthandler.rst @@ -6,6 +6,8 @@ .. versionadded:: 3.3 +---------------- + This module contains functions to dump Python tracebacks explicitly, on a fault, after a timeout, or on a user signal. Call :func:`faulthandler.enable` to install fault handlers for the :const:`SIGSEGV`, :const:`SIGFPE`, diff --git a/Doc/library/fcntl.rst b/Doc/library/fcntl.rst index 508c4a5..88112f6 100644 --- a/Doc/library/fcntl.rst +++ b/Doc/library/fcntl.rst @@ -4,13 +4,15 @@ .. module:: fcntl :platform: Unix :synopsis: The fcntl() and ioctl() system calls. -.. sectionauthor:: Jaap Vermeulen +.. sectionauthor:: Jaap Vermeulen .. index:: pair: UNIX; file control pair: UNIX; I/O control +---------------- + This module performs file control and I/O control on file descriptors. It is an interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines. For a complete description of these calls, see :manpage:`fcntl(2)` and diff --git a/Doc/library/filecmp.rst b/Doc/library/filecmp.rst index 06d3f21..31b9b4a 100644 --- a/Doc/library/filecmp.rst +++ b/Doc/library/filecmp.rst @@ -3,6 +3,7 @@ .. module:: filecmp :synopsis: Compare files efficiently. + .. sectionauthor:: Moshe Zadka **Source code:** :source:`Lib/filecmp.py` diff --git a/Doc/library/fileinput.rst b/Doc/library/fileinput.rst index a55bbe3..aa4c529 100644 --- a/Doc/library/fileinput.rst +++ b/Doc/library/fileinput.rst @@ -3,6 +3,7 @@ .. module:: fileinput :synopsis: Loop over standard input or a list of files. + .. moduleauthor:: Guido van Rossum .. sectionauthor:: Fred L. Drake, Jr. diff --git a/Doc/library/fnmatch.rst b/Doc/library/fnmatch.rst index 68b437f..85ac484 100644 --- a/Doc/library/fnmatch.rst +++ b/Doc/library/fnmatch.rst @@ -4,13 +4,12 @@ .. module:: fnmatch :synopsis: Unix shell style filename pattern matching. +**Source code:** :source:`Lib/fnmatch.py` .. index:: single: filenames; wildcard expansion .. index:: module: re -**Source code:** :source:`Lib/fnmatch.py` - -------------- This module provides support for Unix shell-style wildcards, which are *not* the diff --git a/Doc/library/formatter.rst b/Doc/library/formatter.rst index 8e8e201..6c10ac6 100644 --- a/Doc/library/formatter.rst +++ b/Doc/library/formatter.rst @@ -8,6 +8,7 @@ .. deprecated:: 3.4 Due to lack of usage, the formatter module has been deprecated. +-------------- This module supports two interface definitions, each with multiple implementations: The *formatter* interface, and the *writer* interface which is diff --git a/Doc/library/fpectl.rst b/Doc/library/fpectl.rst index fb15f69..e4b528c 100644 --- a/Doc/library/fpectl.rst +++ b/Doc/library/fpectl.rst @@ -4,10 +4,10 @@ .. module:: fpectl :platform: Unix :synopsis: Provide control for floating point exception handling. + .. moduleauthor:: Lee Busby .. sectionauthor:: Lee Busby - .. note:: The :mod:`fpectl` module is not built by default, and its usage is discouraged @@ -16,6 +16,8 @@ .. index:: single: IEEE-754 +-------------- + Most computers carry out floating point operations in conformance with the so-called IEEE-754 standard. On any real computer, some floating point operations produce results that cannot be expressed as a normal floating point diff --git a/Doc/library/fractions.rst b/Doc/library/fractions.rst index d24f80a..b5a818e 100644 --- a/Doc/library/fractions.rst +++ b/Doc/library/fractions.rst @@ -3,6 +3,7 @@ .. module:: fractions :synopsis: Rational numbers. + .. moduleauthor:: Jeffrey Yasskin .. sectionauthor:: Jeffrey Yasskin diff --git a/Doc/library/ftplib.rst b/Doc/library/ftplib.rst index 242d236..233e11f 100644 --- a/Doc/library/ftplib.rst +++ b/Doc/library/ftplib.rst @@ -4,13 +4,12 @@ .. module:: ftplib :synopsis: FTP protocol client (requires sockets). +**Source code:** :source:`Lib/ftplib.py` .. index:: pair: FTP; protocol single: FTP; ftplib (standard module) -**Source code:** :source:`Lib/ftplib.py` - -------------- This module defines the class :class:`FTP` and a few related items. The diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst index f4d7fdf..2dbcb5c 100644 --- a/Doc/library/functools.rst +++ b/Doc/library/functools.rst @@ -3,6 +3,7 @@ .. module:: functools :synopsis: Higher-order functions and operations on callable objects. + .. moduleauthor:: Peter Harris .. moduleauthor:: Raymond Hettinger .. moduleauthor:: Nick Coghlan diff --git a/Doc/library/gc.rst b/Doc/library/gc.rst index d11c2e1..4af16a9 100644 --- a/Doc/library/gc.rst +++ b/Doc/library/gc.rst @@ -3,9 +3,11 @@ .. module:: gc :synopsis: Interface to the cycle-detecting garbage collector. + .. moduleauthor:: Neil Schemenauer .. sectionauthor:: Neil Schemenauer +-------------- This module provides an interface to the optional garbage collector. It provides the ability to disable the collector, tune the collection frequency, diff --git a/Doc/library/getopt.rst b/Doc/library/getopt.rst index 832d458..336deab 100644 --- a/Doc/library/getopt.rst +++ b/Doc/library/getopt.rst @@ -7,8 +7,6 @@ **Source code:** :source:`Lib/getopt.py` --------------- - .. note:: The :mod:`getopt` module is a parser for command line options whose API is @@ -17,6 +15,8 @@ less code and get better help and error messages should consider using the :mod:`argparse` module instead. +-------------- + This module helps scripts to parse the command line arguments in ``sys.argv``. It supports the same conventions as the Unix :c:func:`getopt` function (including the special meanings of arguments of the form '``-``' and '``--``'). Long diff --git a/Doc/library/getpass.rst b/Doc/library/getpass.rst index 94cf95f..5eb9f04 100644 --- a/Doc/library/getpass.rst +++ b/Doc/library/getpass.rst @@ -3,10 +3,15 @@ .. module:: getpass :synopsis: Portable reading of passwords and retrieval of the userid. + .. moduleauthor:: Piers Lauder .. sectionauthor:: Fred L. Drake, Jr. .. Windows (& Mac?) support by Guido van Rossum. +**Source code:** :source:`Lib/getpass.py` + +-------------- + The :mod:`getpass` module provides two functions: diff --git a/Doc/library/gettext.rst b/Doc/library/gettext.rst index 514cc5a..ea439b5 100644 --- a/Doc/library/gettext.rst +++ b/Doc/library/gettext.rst @@ -3,6 +3,7 @@ .. module:: gettext :synopsis: Multilingual internationalization services. + .. moduleauthor:: Barry A. Warsaw .. sectionauthor:: Barry A. Warsaw diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst index 4c01bf6..328eef3 100644 --- a/Doc/library/glob.rst +++ b/Doc/library/glob.rst @@ -4,11 +4,10 @@ .. module:: glob :synopsis: Unix shell style pathname pattern expansion. +**Source code:** :source:`Lib/glob.py` .. index:: single: filenames; pathname expansion -**Source code:** :source:`Lib/glob.py` - -------------- The :mod:`glob` module finds all the pathnames matching a specified pattern diff --git a/Doc/library/grp.rst b/Doc/library/grp.rst index 8882140..a30e622 100644 --- a/Doc/library/grp.rst +++ b/Doc/library/grp.rst @@ -5,6 +5,7 @@ :platform: Unix :synopsis: The group database (getgrnam() and friends). +-------------- This module provides access to the Unix group database. It is available on all Unix versions. diff --git a/Doc/library/hashlib.rst b/Doc/library/hashlib.rst index 900764b..30be335 100644 --- a/Doc/library/hashlib.rst +++ b/Doc/library/hashlib.rst @@ -3,16 +3,16 @@ .. module:: hashlib :synopsis: Secure hash and message digest algorithms. + .. moduleauthor:: Gregory P. Smith .. sectionauthor:: Gregory P. Smith +**Source code:** :source:`Lib/hashlib.py` .. index:: single: message digest, MD5 single: secure hash algorithm, SHA1, SHA224, SHA256, SHA384, SHA512 -**Source code:** :source:`Lib/hashlib.py` - -------------- This module implements a common interface to many different secure hash and diff --git a/Doc/library/heapq.rst b/Doc/library/heapq.rst index 45720bf..7e33e74 100644 --- a/Doc/library/heapq.rst +++ b/Doc/library/heapq.rst @@ -3,6 +3,7 @@ .. module:: heapq :synopsis: Heap queue algorithm (a.k.a. priority queue). + .. moduleauthor:: Kevin O'Connor .. sectionauthor:: Guido van Rossum .. sectionauthor:: François Pinard diff --git a/Doc/library/hmac.rst b/Doc/library/hmac.rst index 1446da6..bb44866 100644 --- a/Doc/library/hmac.rst +++ b/Doc/library/hmac.rst @@ -3,6 +3,7 @@ .. module:: hmac :synopsis: Keyed-Hashing for Message Authentication (HMAC) implementation + .. moduleauthor:: Gerhard Häring .. sectionauthor:: Gerhard Häring diff --git a/Doc/library/html.entities.rst b/Doc/library/html.entities.rst index 7e29280..067e1b1 100644 --- a/Doc/library/html.entities.rst +++ b/Doc/library/html.entities.rst @@ -3,6 +3,7 @@ .. module:: html.entities :synopsis: Definitions of HTML general entities. + .. sectionauthor:: Fred L. Drake, Jr. **Source code:** :source:`Lib/html/entities.py` diff --git a/Doc/library/html.parser.rst b/Doc/library/html.parser.rst index 2f93c0b..16abb40 100644 --- a/Doc/library/html.parser.rst +++ b/Doc/library/html.parser.rst @@ -4,13 +4,12 @@ .. module:: html.parser :synopsis: A simple parser that can handle HTML and XHTML. +**Source code:** :source:`Lib/html/parser.py` .. index:: single: HTML single: XHTML -**Source code:** :source:`Lib/html/parser.py` - -------------- This module defines a class :class:`HTMLParser` which serves as the basis for diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst index 5a6a4a7..8954648 100644 --- a/Doc/library/http.client.rst +++ b/Doc/library/http.client.rst @@ -4,6 +4,7 @@ .. module:: http.client :synopsis: HTTP and HTTPS protocol client (requires sockets). +**Source code:** :source:`Lib/http/client.py` .. index:: pair: HTTP; protocol @@ -11,8 +12,6 @@ .. index:: module: urllib.request -**Source code:** :source:`Lib/http/client.py` - -------------- This module defines classes which implement the client side of the HTTP and diff --git a/Doc/library/http.cookiejar.rst b/Doc/library/http.cookiejar.rst index f2e1c69..5370601 100644 --- a/Doc/library/http.cookiejar.rst +++ b/Doc/library/http.cookiejar.rst @@ -3,6 +3,7 @@ .. module:: http.cookiejar :synopsis: Classes for automatic handling of HTTP cookies. + .. moduleauthor:: John J. Lee .. sectionauthor:: John J. Lee diff --git a/Doc/library/http.cookies.rst b/Doc/library/http.cookies.rst index 56c52f8..4b45d4b 100644 --- a/Doc/library/http.cookies.rst +++ b/Doc/library/http.cookies.rst @@ -3,6 +3,7 @@ .. module:: http.cookies :synopsis: Support for HTTP state management (cookies). + .. moduleauthor:: Timothy O'Malley .. sectionauthor:: Moshe Zadka diff --git a/Doc/library/http.rst b/Doc/library/http.rst index 1fce9c9..be661c5 100644 --- a/Doc/library/http.rst +++ b/Doc/library/http.rst @@ -4,11 +4,13 @@ .. module:: http :synopsis: HTTP status codes and messages +**Source code:** :source:`Lib/http/__init__.py` + .. index:: pair: HTTP; protocol single: HTTP; http (standard module) -**Source code:** :source:`Lib/http/__init__.py` +-------------- :mod:`http` is a package that collects several modules for working with the HyperText Transfer Protocol: diff --git a/Doc/library/http.server.rst b/Doc/library/http.server.rst index 05ad2d7..16c4fac 100644 --- a/Doc/library/http.server.rst +++ b/Doc/library/http.server.rst @@ -4,6 +4,7 @@ .. module:: http.server :synopsis: HTTP server and request handlers. +**Source code:** :source:`Lib/http/server.py` .. index:: pair: WWW; server @@ -11,8 +12,6 @@ single: URL single: httpd -**Source code:** :source:`Lib/http/server.py` - -------------- This module defines classes for implementing HTTP servers (Web servers). diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index 2140e85..9ca92ce 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -3,12 +3,16 @@ IDLE ==== +.. moduleauthor:: Guido van Rossum + +**Source code:** :source:`Lib/idlelib/` + .. index:: single: IDLE single: Python Editor single: Integrated Development Environment -.. moduleauthor:: Guido van Rossum +-------------- IDLE is Python's Integrated Development and Learning Environment. diff --git a/Doc/library/imaplib.rst b/Doc/library/imaplib.rst index dbd8e77..c25e7d8 100644 --- a/Doc/library/imaplib.rst +++ b/Doc/library/imaplib.rst @@ -3,6 +3,7 @@ .. module:: imaplib :synopsis: IMAP4 protocol client (requires sockets). + .. moduleauthor:: Piers Lauder .. sectionauthor:: Piers Lauder .. revised by ESR, January 2000 @@ -10,14 +11,13 @@ .. changes for IMAP4_stream by Piers Lauder , November 2002 +**Source code:** :source:`Lib/imaplib.py` .. index:: pair: IMAP4; protocol pair: IMAP4_SSL; protocol pair: IMAP4_stream; protocol -**Source code:** :source:`Lib/imaplib.py` - -------------- This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and diff --git a/Doc/library/imp.rst b/Doc/library/imp.rst index 68a6b68..9828ba6 100644 --- a/Doc/library/imp.rst +++ b/Doc/library/imp.rst @@ -5,11 +5,15 @@ :synopsis: Access the implementation of the import statement. :deprecated: +**Source code:** :source:`Lib/imp.py` + .. deprecated:: 3.4 The :mod:`imp` package is pending deprecation in favor of :mod:`importlib`. .. index:: statement: import +-------------- + This module provides an interface to the mechanisms used to implement the :keyword:`import` statement. It defines the following constants and functions: diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index 953e21b..3302446 100644 --- a/Doc/library/importlib.rst +++ b/Doc/library/importlib.rst @@ -9,6 +9,9 @@ .. versionadded:: 3.1 +**Source code:** :source:`Lib/importlib/__init__.py` + +-------------- Introduction ------------ diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst index ff628de..b28d0f9 100644 --- a/Doc/library/inspect.rst +++ b/Doc/library/inspect.rst @@ -3,6 +3,7 @@ .. module:: inspect :synopsis: Extract information and source code from live objects. + .. moduleauthor:: Ka-Ping Yee .. sectionauthor:: Ka-Ping Yee diff --git a/Doc/library/io.rst b/Doc/library/io.rst index 53d6f27..23df18f 100644 --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -3,6 +3,7 @@ .. module:: io :synopsis: Core tools for working with streams. + .. moduleauthor:: Guido van Rossum .. moduleauthor:: Mike Verdone .. moduleauthor:: Mark Russell @@ -11,6 +12,10 @@ .. moduleauthor:: Benjamin Peterson .. sectionauthor:: Benjamin Peterson +**Source code:** :source:`Lib/io.py` + +-------------- + .. _io-overview: Overview diff --git a/Doc/library/ipaddress.rst b/Doc/library/ipaddress.rst index f6bfcf9..23526b6 100644 --- a/Doc/library/ipaddress.rst +++ b/Doc/library/ipaddress.rst @@ -3,6 +3,7 @@ .. module:: ipaddress :synopsis: IPv4/IPv6 manipulation library. + .. moduleauthor:: Peter Moody **Source code:** :source:`Lib/ipaddress.py` diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst index c6e2544..dfc1ddc 100644 --- a/Doc/library/itertools.rst +++ b/Doc/library/itertools.rst @@ -3,14 +3,15 @@ .. module:: itertools :synopsis: Functions creating iterators for efficient looping. + .. moduleauthor:: Raymond Hettinger .. sectionauthor:: Raymond Hettinger - .. testsetup:: from itertools import * +-------------- This module implements a number of :term:`iterator` building blocks inspired by constructs from APL, Haskell, and SML. Each has been recast in a form diff --git a/Doc/library/json.rst b/Doc/library/json.rst index c41b4a3..174e734 100644 --- a/Doc/library/json.rst +++ b/Doc/library/json.rst @@ -3,9 +3,14 @@ .. module:: json :synopsis: Encode and decode the JSON format. + .. moduleauthor:: Bob Ippolito .. sectionauthor:: Bob Ippolito +**Source code:** :source:`Lib/json/__init__.py` + +-------------- + `JSON (JavaScript Object Notation) `_, specified by :rfc:`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 `_, diff --git a/Doc/library/linecache.rst b/Doc/library/linecache.rst index 3f14885..ae3de9f 100644 --- a/Doc/library/linecache.rst +++ b/Doc/library/linecache.rst @@ -3,6 +3,7 @@ .. module:: linecache :synopsis: This module provides random access to individual lines from text files. + .. sectionauthor:: Moshe Zadka **Source code:** :source:`Lib/linecache.py` diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst index dd17d4f..5aaf4a3 100644 --- a/Doc/library/locale.rst +++ b/Doc/library/locale.rst @@ -3,9 +3,13 @@ .. module:: locale :synopsis: Internationalization services. + .. moduleauthor:: Martin von Löwis .. sectionauthor:: Martin von Löwis +**Source code:** :source:`Lib/locale.py` + +-------------- The :mod:`locale` module opens access to the POSIX locale database and functionality. The POSIX locale mechanism allows programmers to deal with diff --git a/Doc/library/logging.config.rst b/Doc/library/logging.config.rst index fd6a477..e196724 100644 --- a/Doc/library/logging.config.rst +++ b/Doc/library/logging.config.rst @@ -4,10 +4,11 @@ .. module:: logging.config :synopsis: Configuration of the logging module. - .. moduleauthor:: Vinay Sajip .. sectionauthor:: Vinay Sajip +**Source code:** :source:`Lib/logging/config.py` + .. sidebar:: Important This page contains only reference information. For tutorials, @@ -17,8 +18,6 @@ * :ref:`Advanced Tutorial ` * :ref:`Logging Cookbook ` -**Source code:** :source:`Lib/logging/config.py` - -------------- This section describes the API for configuring the logging module. diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst index 5936e12..855adab 100644 --- a/Doc/library/logging.handlers.rst +++ b/Doc/library/logging.handlers.rst @@ -4,10 +4,11 @@ .. module:: logging.handlers :synopsis: Handlers for the logging module. - .. moduleauthor:: Vinay Sajip .. sectionauthor:: Vinay Sajip +**Source code:** :source:`Lib/logging/handlers.py` + .. sidebar:: Important This page contains only reference information. For tutorials, @@ -17,8 +18,6 @@ * :ref:`Advanced Tutorial ` * :ref:`Logging Cookbook ` -**Source code:** :source:`Lib/logging/handlers.py` - -------------- .. currentmodule:: logging diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index 8c834f0..72da385 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -4,10 +4,10 @@ .. module:: logging :synopsis: Flexible event logging system for applications. - .. moduleauthor:: Vinay Sajip .. sectionauthor:: Vinay Sajip +**Source code:** :source:`Lib/logging/__init__.py` .. index:: pair: Errors; logging @@ -20,9 +20,6 @@ * :ref:`Advanced Tutorial ` * :ref:`Logging Cookbook ` - -**Source code:** :source:`Lib/logging/__init__.py` - -------------- This module defines functions and classes which implement a flexible event diff --git a/Doc/library/lzma.rst b/Doc/library/lzma.rst index 0546005..f99c495 100644 --- a/Doc/library/lzma.rst +++ b/Doc/library/lzma.rst @@ -3,11 +3,15 @@ .. module:: lzma :synopsis: A Python wrapper for the liblzma compression library. + .. moduleauthor:: Nadeem Vawda .. sectionauthor:: Nadeem Vawda .. versionadded:: 3.3 +**Source code:** :source:`Lib/lzma.py` + +-------------- This module provides classes and convenience functions for compressing and decompressing data using the LZMA compression algorithm. Also included is a file diff --git a/Doc/library/macpath.rst b/Doc/library/macpath.rst index b7a5d89..b08bbe0 100644 --- a/Doc/library/macpath.rst +++ b/Doc/library/macpath.rst @@ -4,6 +4,9 @@ .. module:: macpath :synopsis: Mac OS 9 path manipulation functions. +**Source code:** :source:`Lib/macpath.py` + +-------------- This module is the Mac OS 9 (and earlier) implementation of the :mod:`os.path` module. It can be used to manipulate old-style Macintosh pathnames on Mac OS X diff --git a/Doc/library/mailbox.rst b/Doc/library/mailbox.rst index 1082bf9..81244c2 100644 --- a/Doc/library/mailbox.rst +++ b/Doc/library/mailbox.rst @@ -3,9 +3,13 @@ .. module:: mailbox :synopsis: Manipulate mailboxes in various formats + .. moduleauthor:: Gregory K. Johnson .. sectionauthor:: Gregory K. Johnson +**Source code:** :source:`Lib/mailbox.py` + +-------------- This module defines two classes, :class:`Mailbox` and :class:`Message`, for accessing and manipulating on-disk mailboxes and the messages they contain. diff --git a/Doc/library/marshal.rst b/Doc/library/marshal.rst index 8bf0e03..1ffc6ef 100644 --- a/Doc/library/marshal.rst +++ b/Doc/library/marshal.rst @@ -5,6 +5,7 @@ :synopsis: Convert Python objects to streams of bytes and back (with different constraints). +-------------- This module contains functions that can read and write Python values in a binary format. The format is specific to Python, but independent of machine diff --git a/Doc/library/math.rst b/Doc/library/math.rst index 80e65bb..3fdea18 100644 --- a/Doc/library/math.rst +++ b/Doc/library/math.rst @@ -8,6 +8,8 @@ from math import fsum +-------------- + This module is always available. It provides access to the mathematical functions defined by the C standard. diff --git a/Doc/library/mimetypes.rst b/Doc/library/mimetypes.rst index 9e91b8a..464248c 100644 --- a/Doc/library/mimetypes.rst +++ b/Doc/library/mimetypes.rst @@ -3,13 +3,13 @@ .. module:: mimetypes :synopsis: Mapping of filename extensions to MIME types. + .. sectionauthor:: Fred L. Drake, Jr. +**Source code:** :source:`Lib/mimetypes.py` .. index:: pair: MIME; content type -**Source code:** :source:`Lib/mimetypes.py` - -------------- The :mod:`mimetypes` module converts between a filename or URL and the MIME type diff --git a/Doc/library/mmap.rst b/Doc/library/mmap.rst index ce807e4..8f53833 100644 --- a/Doc/library/mmap.rst +++ b/Doc/library/mmap.rst @@ -4,6 +4,7 @@ .. module:: mmap :synopsis: Interface to memory-mapped files for Unix and Windows. +-------------- Memory-mapped file objects behave like both :class:`bytearray` and like :term:`file objects `. You can use mmap objects in most places diff --git a/Doc/library/modulefinder.rst b/Doc/library/modulefinder.rst index e84a496..7b39ce7 100644 --- a/Doc/library/modulefinder.rst +++ b/Doc/library/modulefinder.rst @@ -1,12 +1,11 @@ :mod:`modulefinder` --- Find modules used by a script ===================================================== -.. sectionauthor:: A.M. Kuchling - - .. module:: modulefinder :synopsis: Find modules used by a script. +.. sectionauthor:: A.M. Kuchling + **Source code:** :source:`Lib/modulefinder.py` -------------- diff --git a/Doc/library/msilib.rst b/Doc/library/msilib.rst index 15768e1..0a42032 100644 --- a/Doc/library/msilib.rst +++ b/Doc/library/msilib.rst @@ -4,12 +4,16 @@ .. module:: msilib :platform: Windows :synopsis: Creation of Microsoft Installer files, and CAB files. + .. moduleauthor:: Martin v. Löwis .. sectionauthor:: Martin v. Löwis +**Source code:** :source:`Lib/msilib/__init__.py` .. index:: single: msi +-------------- + The :mod:`msilib` supports the creation of Microsoft Installer (``.msi``) files. Because these files often contain an embedded "cabinet" file (``.cab``), it also exposes an API to create CAB files. Support for reading ``.cab`` files is diff --git a/Doc/library/msvcrt.rst b/Doc/library/msvcrt.rst index fadaf05..b334eeb 100644 --- a/Doc/library/msvcrt.rst +++ b/Doc/library/msvcrt.rst @@ -4,8 +4,10 @@ .. module:: msvcrt :platform: Windows :synopsis: Miscellaneous useful routines from the MS VC++ runtime. + .. sectionauthor:: Fred L. Drake, Jr. +-------------- These functions provide access to some useful capabilities on Windows platforms. Some higher-level modules use these functions to build the Windows diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index be6c28c..c5c092c 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -4,6 +4,9 @@ .. module:: multiprocessing :synopsis: Process-based parallelism. +**Source code:** :source:`Lib/multiprocessing/` + +-------------- Introduction ------------ diff --git a/Doc/library/netrc.rst b/Doc/library/netrc.rst index 23ffed6..cdc2616 100644 --- a/Doc/library/netrc.rst +++ b/Doc/library/netrc.rst @@ -4,6 +4,7 @@ .. module:: netrc :synopsis: Loading of .netrc files. + .. moduleauthor:: Eric S. Raymond .. sectionauthor:: Eric S. Raymond diff --git a/Doc/library/nis.rst b/Doc/library/nis.rst index 9e2b572..10c67cb 100644 --- a/Doc/library/nis.rst +++ b/Doc/library/nis.rst @@ -5,9 +5,11 @@ .. module:: nis :platform: Unix :synopsis: Interface to Sun's NIS (Yellow Pages) library. + .. moduleauthor:: Fred Gansevles .. sectionauthor:: Moshe Zadka +-------------- The :mod:`nis` module gives a thin wrapper around the NIS library, useful for central administration of several hosts. diff --git a/Doc/library/nntplib.rst b/Doc/library/nntplib.rst index 9fb1b45..9790e3a 100644 --- a/Doc/library/nntplib.rst +++ b/Doc/library/nntplib.rst @@ -4,13 +4,12 @@ .. module:: nntplib :synopsis: NNTP protocol client (requires sockets). +**Source code:** :source:`Lib/nntplib.py` .. index:: pair: NNTP; protocol single: Network News Transfer Protocol -**Source code:** :source:`Lib/nntplib.py` - -------------- This module defines the class :class:`NNTP` which implements the client side of diff --git a/Doc/library/numbers.rst b/Doc/library/numbers.rst index 718a50e..1b59495 100644 --- a/Doc/library/numbers.rst +++ b/Doc/library/numbers.rst @@ -4,6 +4,9 @@ .. module:: numbers :synopsis: Numeric abstract base classes (Complex, Real, Integral, etc.). +**Source code:** :source:`Lib/numbers.py` + +-------------- The :mod:`numbers` module (:pep:`3141`) defines a hierarchy of numeric :term:`abstract base classes ` which progressively define diff --git a/Doc/library/operator.rst b/Doc/library/operator.rst index c01e63b..8121b48 100644 --- a/Doc/library/operator.rst +++ b/Doc/library/operator.rst @@ -3,16 +3,16 @@ .. module:: operator :synopsis: Functions corresponding to the standard operators. + .. sectionauthor:: Skip Montanaro +**Source code:** :source:`Lib/operator.py` .. testsetup:: import operator from operator import itemgetter, iadd -**Source code:** :source:`Lib/operator.py` - -------------- The :mod:`operator` module exports a set of efficient functions corresponding to diff --git a/Doc/library/optparse.rst b/Doc/library/optparse.rst index c5db3ea..9a4ba4e 100644 --- a/Doc/library/optparse.rst +++ b/Doc/library/optparse.rst @@ -4,15 +4,16 @@ .. module:: optparse :synopsis: Command-line option parsing library. :deprecated: + .. moduleauthor:: Greg Ward .. sectionauthor:: Greg Ward +**Source code:** :source:`Lib/optparse.py` + .. deprecated:: 3.2 The :mod:`optparse` module is deprecated and will not be developed further; development will continue with the :mod:`argparse` module. -**Source code:** :source:`Lib/optparse.py` - -------------- :mod:`optparse` is a more convenient, flexible, and powerful library for parsing diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst index 3703a20..bf0dfac 100644 --- a/Doc/library/os.path.rst +++ b/Doc/library/os.path.rst @@ -4,8 +4,14 @@ .. module:: os.path :synopsis: Operations on pathnames. +**Source code:** :source:`Lib/posixpath.py` (for POSIX), +:source:`Lib/ntpath.py` (for Windows NT), +and :source:`Lib/macpath.py` (for Macintosh) + .. index:: single: path; operations +-------------- + This module implements some useful functions on pathnames. To read or write files see :func:`open`, and for accessing the filesystem see the :mod:`os` module. The path parameters can be passed as either strings, diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 80de2bd..743efb6 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -4,6 +4,9 @@ .. module:: os :synopsis: Miscellaneous operating system interfaces. +**Source code:** :source:`Lib/os.py` + +-------------- This module provides a portable way of using operating system dependent functionality. If you just want to read or write a file see :func:`open`, if diff --git a/Doc/library/ossaudiodev.rst b/Doc/library/ossaudiodev.rst index 211328f..ec40c0b9 100644 --- a/Doc/library/ossaudiodev.rst +++ b/Doc/library/ossaudiodev.rst @@ -5,6 +5,7 @@ :platform: Linux, FreeBSD :synopsis: Access to OSS-compatible audio devices. +-------------- This module allows you to access the OSS (Open Sound System) audio interface. OSS is available for a wide range of open-source and commercial Unices, and is diff --git a/Doc/library/parser.rst b/Doc/library/parser.rst index 3e1e31b..c3b699a 100644 --- a/Doc/library/parser.rst +++ b/Doc/library/parser.rst @@ -3,10 +3,10 @@ .. module:: parser :synopsis: Access parse trees for Python source code. + .. moduleauthor:: Fred L. Drake, Jr. .. sectionauthor:: Fred L. Drake, Jr. - .. Copyright 1995 Virginia Polytechnic Institute and State University and Fred L. Drake, Jr. This copyright notice must be distributed on all copies, but this document otherwise may be distributed as part of the Python @@ -16,6 +16,8 @@ .. index:: single: parsing; Python source code +-------------- + The :mod:`parser` module provides an interface to Python's internal parser and byte-code compiler. The primary purpose for this interface is to allow Python code to edit the parse tree of a Python expression and create executable code diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst index 2f06544..f803fb6 100644 --- a/Doc/library/pathlib.rst +++ b/Doc/library/pathlib.rst @@ -5,9 +5,13 @@ .. module:: pathlib :synopsis: Object-oriented filesystem paths +.. versionadded:: 3.4 + +**Source code:** :source:`Lib/pathlib.py` + .. index:: single: path; operations -.. versionadded:: 3.4 +-------------- This module offers classes representing filesystem paths with semantics appropriate for different operating systems. Path classes are divided diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst index c144db6..4520a9b 100644 --- a/Doc/library/pdb.rst +++ b/Doc/library/pdb.rst @@ -8,10 +8,10 @@ **Source code:** :source:`Lib/pdb.py` --------------- - .. index:: single: debugging +-------------- + The module :mod:`pdb` defines an interactive source code debugger for Python programs. It supports setting (conditional) breakpoints and single stepping at the source line level, inspection of stack frames, source code listing, and diff --git a/Doc/library/pickle.rst b/Doc/library/pickle.rst index 7e09b03..0d64191 100644 --- a/Doc/library/pickle.rst +++ b/Doc/library/pickle.rst @@ -1,6 +1,14 @@ :mod:`pickle` --- Python object serialization ============================================= +.. module:: pickle + :synopsis: Convert Python objects to streams of bytes and back. + +.. sectionauthor:: Jim Kerr . +.. sectionauthor:: Barry Warsaw + +**Source code:** :source:`Lib/pickle.py` + .. index:: single: persistence pair: persistent; objects @@ -9,11 +17,7 @@ pair: flattening; objects pair: pickling; objects -.. module:: pickle - :synopsis: Convert Python objects to streams of bytes and back. -.. sectionauthor:: Jim Kerr . -.. sectionauthor:: Barry Warsaw - +-------------- The :mod:`pickle` module implements binary protocols for serializing and de-serializing a Python object structure. *"Pickling"* is the process diff --git a/Doc/library/pipes.rst b/Doc/library/pipes.rst index 69e891d..0a22da1 100644 --- a/Doc/library/pipes.rst +++ b/Doc/library/pipes.rst @@ -4,6 +4,7 @@ .. module:: pipes :platform: Unix :synopsis: A Python interface to Unix shell pipelines. + .. sectionauthor:: Moshe Zadka **Source code:** :source:`Lib/pipes.py` diff --git a/Doc/library/platform.rst b/Doc/library/platform.rst index e679317..eea0abb 100644 --- a/Doc/library/platform.rst +++ b/Doc/library/platform.rst @@ -3,6 +3,7 @@ .. module:: platform :synopsis: Retrieves as much platform identifying data as possible. + .. moduleauthor:: Marc-André Lemburg .. sectionauthor:: Bjorn Pettersen diff --git a/Doc/library/plistlib.rst b/Doc/library/plistlib.rst index 2c1f3dd..9ba2266 100644 --- a/Doc/library/plistlib.rst +++ b/Doc/library/plistlib.rst @@ -3,16 +3,17 @@ .. module:: plistlib :synopsis: Generate and parse Mac OS X plist files. + .. moduleauthor:: Jack Jansen .. sectionauthor:: Georg Brandl .. (harvested from docstrings in the original file) +**Source code:** :source:`Lib/plistlib.py` + .. index:: pair: plist; file single: property list -**Source code:** :source:`Lib/plistlib.py` - -------------- This module provides an interface for reading and writing the "property list" diff --git a/Doc/library/poplib.rst b/Doc/library/poplib.rst index 8468f4c..ffabc32 100644 --- a/Doc/library/poplib.rst +++ b/Doc/library/poplib.rst @@ -3,13 +3,14 @@ .. module:: poplib :synopsis: POP3 protocol client (requires sockets). + .. sectionauthor:: Andrew T. Csillag .. revised by ESR, January 2000 -.. index:: pair: POP3; protocol - **Source code:** :source:`Lib/poplib.py` +.. index:: pair: POP3; protocol + -------------- This module defines a class, :class:`POP3`, which encapsulates a connection to a diff --git a/Doc/library/posix.rst b/Doc/library/posix.rst index 06bab04..9cbc550 100644 --- a/Doc/library/posix.rst +++ b/Doc/library/posix.rst @@ -5,6 +5,7 @@ :platform: Unix :synopsis: The most common POSIX system calls (normally used via module os). +-------------- This module provides access to operating system functionality that is standardized by the C Standard and the POSIX standard (a thinly disguised Unix diff --git a/Doc/library/pprint.rst b/Doc/library/pprint.rst index b109efe..65d94fe 100644 --- a/Doc/library/pprint.rst +++ b/Doc/library/pprint.rst @@ -3,6 +3,7 @@ .. module:: pprint :synopsis: Data pretty printer. + .. moduleauthor:: Fred L. Drake, Jr. .. sectionauthor:: Fred L. Drake, Jr. diff --git a/Doc/library/pty.rst b/Doc/library/pty.rst index b8a3897..0ab7660 100644 --- a/Doc/library/pty.rst +++ b/Doc/library/pty.rst @@ -4,9 +4,13 @@ .. module:: pty :platform: Linux :synopsis: Pseudo-Terminal Handling for Linux. + .. moduleauthor:: Steen Lumholt .. sectionauthor:: Moshe Zadka +**Source code:** :source:`Lib/pty.py` + +-------------- The :mod:`pty` module defines operations for handling the pseudo-terminal concept: starting another process and being able to write to and read from its diff --git a/Doc/library/pwd.rst b/Doc/library/pwd.rst index 2c17d9e..03ebb02 100644 --- a/Doc/library/pwd.rst +++ b/Doc/library/pwd.rst @@ -5,6 +5,7 @@ :platform: Unix :synopsis: The password database (getpwnam() and friends). +-------------- This module provides access to the Unix user account and password database. It is available on all Unix versions. diff --git a/Doc/library/py_compile.rst b/Doc/library/py_compile.rst index 97f2b20..65f76b8 100644 --- a/Doc/library/py_compile.rst +++ b/Doc/library/py_compile.rst @@ -3,13 +3,14 @@ .. module:: py_compile :synopsis: Generate byte-code files from Python source files. + .. sectionauthor:: Fred L. Drake, Jr. .. documentation based on module docstrings -.. index:: pair: file; byte-code - **Source code:** :source:`Lib/py_compile.py` +.. index:: pair: file; byte-code + -------------- The :mod:`py_compile` module provides a function to generate a byte-code file diff --git a/Doc/library/pyclbr.rst b/Doc/library/pyclbr.rst index 13eaabf..3284271 100644 --- a/Doc/library/pyclbr.rst +++ b/Doc/library/pyclbr.rst @@ -3,6 +3,7 @@ .. module:: pyclbr :synopsis: Supports information extraction for a Python class browser. + .. sectionauthor:: Fred L. Drake, Jr. **Source code:** :source:`Lib/pyclbr.py` diff --git a/Doc/library/pydoc.rst b/Doc/library/pydoc.rst index b5e3233..f1bfab9 100644 --- a/Doc/library/pydoc.rst +++ b/Doc/library/pydoc.rst @@ -3,17 +3,17 @@ .. module:: pydoc :synopsis: Documentation generator and online help system. + .. moduleauthor:: Ka-Ping Yee .. sectionauthor:: Ka-Ping Yee +**Source code:** :source:`Lib/pydoc.py` .. index:: single: documentation; generation single: documentation; online single: help; online -**Source code:** :source:`Lib/pydoc.py` - -------------- The :mod:`pydoc` module automatically generates documentation from Python diff --git a/Doc/library/pyexpat.rst b/Doc/library/pyexpat.rst index 3bc26ce..29c9f34 100644 --- a/Doc/library/pyexpat.rst +++ b/Doc/library/pyexpat.rst @@ -3,8 +3,10 @@ .. module:: xml.parsers.expat :synopsis: An interface to the Expat non-validating XML parser. + .. moduleauthor:: Paul Prescod +-------------- .. Markup notes: diff --git a/Doc/library/quopri.rst b/Doc/library/quopri.rst index 3a74cf8..3c31125 100644 --- a/Doc/library/quopri.rst +++ b/Doc/library/quopri.rst @@ -4,13 +4,12 @@ .. module:: quopri :synopsis: Encode and decode files using the MIME quoted-printable encoding. +**Source code:** :source:`Lib/quopri.py` .. index:: pair: quoted-printable; encoding single: MIME; quoted-printable encoding -**Source code:** :source:`Lib/quopri.py` - -------------- This module performs quoted-printable transport encoding and decoding, as diff --git a/Doc/library/re.rst b/Doc/library/re.rst index ceb7959..18d5596 100644 --- a/Doc/library/re.rst +++ b/Doc/library/re.rst @@ -3,9 +3,13 @@ .. module:: re :synopsis: Regular expression operations. + .. moduleauthor:: Fredrik Lundh .. sectionauthor:: Andrew M. Kuchling +**Source code:** :source:`Lib/re.py` + +-------------- This module provides regular expression matching operations similar to those found in Perl. diff --git a/Doc/library/readline.rst b/Doc/library/readline.rst index 5f4438e..e17e69c 100644 --- a/Doc/library/readline.rst +++ b/Doc/library/readline.rst @@ -4,8 +4,10 @@ .. module:: readline :platform: Unix :synopsis: GNU readline support for Python. + .. sectionauthor:: Skip Montanaro +-------------- The :mod:`readline` module defines a number of functions to facilitate completion and reading/writing of history files from the Python interpreter. diff --git a/Doc/library/reprlib.rst b/Doc/library/reprlib.rst index ee9a10d..0905b98 100644 --- a/Doc/library/reprlib.rst +++ b/Doc/library/reprlib.rst @@ -3,6 +3,7 @@ .. module:: reprlib :synopsis: Alternate repr() implementation with size limits. + .. sectionauthor:: Fred L. Drake, Jr. **Source code:** :source:`Lib/reprlib.py` diff --git a/Doc/library/resource.rst b/Doc/library/resource.rst index a7b229e..b213793 100644 --- a/Doc/library/resource.rst +++ b/Doc/library/resource.rst @@ -4,9 +4,11 @@ .. module:: resource :platform: Unix :synopsis: An interface to provide resource usage information on the current process. + .. moduleauthor:: Jeremy Hylton .. sectionauthor:: Jeremy Hylton +-------------- This module provides basic mechanisms for measuring and controlling system resources utilized by a program. diff --git a/Doc/library/rlcompleter.rst b/Doc/library/rlcompleter.rst index 9ed01c7..40b09ce 100644 --- a/Doc/library/rlcompleter.rst +++ b/Doc/library/rlcompleter.rst @@ -3,6 +3,7 @@ .. module:: rlcompleter :synopsis: Python identifier completion, suitable for the GNU readline library. + .. sectionauthor:: Moshe Zadka **Source code:** :source:`Lib/rlcompleter.py` diff --git a/Doc/library/runpy.rst b/Doc/library/runpy.rst index 78d0143..af35e81 100644 --- a/Doc/library/runpy.rst +++ b/Doc/library/runpy.rst @@ -3,6 +3,7 @@ .. module:: runpy :synopsis: Locate and run Python modules without importing them first. + .. moduleauthor:: Nick Coghlan **Source code:** :source:`Lib/runpy.py` diff --git a/Doc/library/sched.rst b/Doc/library/sched.rst index 26f59c5..4d4a616 100644 --- a/Doc/library/sched.rst +++ b/Doc/library/sched.rst @@ -3,12 +3,13 @@ .. module:: sched :synopsis: General purpose event scheduler. -.. sectionauthor:: Moshe Zadka -.. index:: single: event scheduling +.. sectionauthor:: Moshe Zadka **Source code:** :source:`Lib/sched.py` +.. index:: single: event scheduling + -------------- The :mod:`sched` module defines a class which implements a general purpose event diff --git a/Doc/library/select.rst b/Doc/library/select.rst index 364b499..6cec9f7 100644 --- a/Doc/library/select.rst +++ b/Doc/library/select.rst @@ -4,6 +4,7 @@ .. module:: select :synopsis: Wait for I/O completion on multiple streams. +-------------- This module provides access to the :c:func:`select` and :c:func:`poll` functions available in most operating systems, :c:func:`devpoll` available on diff --git a/Doc/library/selectors.rst b/Doc/library/selectors.rst index 3847bbd..44b27f3 100644 --- a/Doc/library/selectors.rst +++ b/Doc/library/selectors.rst @@ -6,6 +6,9 @@ .. versionadded:: 3.4 +**Source code:** :source:`Lib/selectors.py` + +-------------- Introduction ------------ diff --git a/Doc/library/shelve.rst b/Doc/library/shelve.rst index f89368b..1ec158e 100644 --- a/Doc/library/shelve.rst +++ b/Doc/library/shelve.rst @@ -4,11 +4,10 @@ .. module:: shelve :synopsis: Python object persistence. +**Source code:** :source:`Lib/shelve.py` .. index:: module: pickle -**Source code:** :source:`Lib/shelve.py` - -------------- A "shelf" is a persistent, dictionary-like object. The difference with "dbm" diff --git a/Doc/library/shlex.rst b/Doc/library/shlex.rst index bf54318..e81f982 100644 --- a/Doc/library/shlex.rst +++ b/Doc/library/shlex.rst @@ -3,6 +3,7 @@ .. module:: shlex :synopsis: Simple lexical analysis for Unix shell-like languages. + .. moduleauthor:: Eric S. Raymond .. moduleauthor:: Gustavo Niemeyer .. sectionauthor:: Eric S. Raymond diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index c39a19a..e9ba4e6 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -3,15 +3,16 @@ .. module:: shutil :synopsis: High-level file operations, including copying. + .. sectionauthor:: Fred L. Drake, Jr. .. partly based on the docstrings +**Source code:** :source:`Lib/shutil.py` + .. index:: single: file; copying single: copying files -**Source code:** :source:`Lib/shutil.py` - -------------- The :mod:`shutil` module offers a number of high-level operations on files and diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst index d02a0a8..61252ce 100644 --- a/Doc/library/signal.rst +++ b/Doc/library/signal.rst @@ -4,6 +4,7 @@ .. module:: signal :synopsis: Set handlers for asynchronous events. +-------------- This module provides mechanisms to use signal handlers in Python. diff --git a/Doc/library/smtplib.rst b/Doc/library/smtplib.rst index 2234d51..bdf3805 100644 --- a/Doc/library/smtplib.rst +++ b/Doc/library/smtplib.rst @@ -3,15 +3,15 @@ .. module:: smtplib :synopsis: SMTP protocol client (requires sockets). + .. sectionauthor:: Eric S. Raymond +**Source code:** :source:`Lib/smtplib.py` .. index:: pair: SMTP; protocol single: Simple Mail Transfer Protocol -**Source code:** :source:`Lib/smtplib.py` - -------------- The :mod:`smtplib` module defines an SMTP client session object that can be used diff --git a/Doc/library/sndhdr.rst b/Doc/library/sndhdr.rst index f8b5d8b..6bfa9a9 100644 --- a/Doc/library/sndhdr.rst +++ b/Doc/library/sndhdr.rst @@ -3,15 +3,16 @@ .. module:: sndhdr :synopsis: Determine type of a sound file. + .. sectionauthor:: Fred L. Drake, Jr. .. Based on comments in the module source file. +**Source code:** :source:`Lib/sndhdr.py` + .. index:: single: A-LAW single: u-LAW -**Source code:** :source:`Lib/sndhdr.py` - -------------- The :mod:`sndhdr` provides utility functions which attempt to determine the type diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index 3aa1b13..48311c5 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -4,6 +4,9 @@ .. module:: socket :synopsis: Low-level networking interface. +**Source code:** :source:`Lib/socket.py` + +-------------- This module provides access to the BSD *socket* interface. It is available on all modern Unix systems, Windows, MacOS, and probably additional platforms. diff --git a/Doc/library/spwd.rst b/Doc/library/spwd.rst index 58be78f..fd3c9ad 100644 --- a/Doc/library/spwd.rst +++ b/Doc/library/spwd.rst @@ -5,6 +5,7 @@ :platform: Unix :synopsis: The shadow password database (getspnam() and friends). +-------------- This module provides access to the Unix shadow password database. It is available on various Unix versions. diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index 996e93e..3bba935 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -3,8 +3,12 @@ .. module:: sqlite3 :synopsis: A DB-API 2.0 implementation using SQLite 3.x. + .. sectionauthor:: Gerhard Häring +**Source code:** :source:`Lib/sqlite3/` + +-------------- SQLite is a C library that provides a lightweight disk-based database that doesn't require a separate server process and allows accessing the database diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index d458d8b..5792d0d 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -7,13 +7,12 @@ .. moduleauthor:: Bill Janssen .. sectionauthor:: Bill Janssen +**Source code:** :source:`Lib/ssl.py` .. index:: single: OpenSSL; (use in module ssl) .. index:: TLS, SSL, Transport Layer Security, Secure Sockets Layer -**Source code:** :source:`Lib/ssl.py` - -------------- This module provides access to Transport Layer Security (often known as "Secure diff --git a/Doc/library/stat.rst b/Doc/library/stat.rst index a2f8a57..b256312 100644 --- a/Doc/library/stat.rst +++ b/Doc/library/stat.rst @@ -4,10 +4,10 @@ .. module:: stat :synopsis: Utilities for interpreting the results of os.stat(), os.lstat() and os.fstat(). + .. sectionauthor:: Skip Montanaro -**Source code:** :source:`Modules/_stat.c` - :source:`Lib/stat.py` +**Source code:** :source:`Lib/stat.py` -------------- diff --git a/Doc/library/statistics.rst b/Doc/library/statistics.rst index 1e1bd9b..ea3d7da 100644 --- a/Doc/library/statistics.rst +++ b/Doc/library/statistics.rst @@ -3,18 +3,19 @@ .. module:: statistics :synopsis: mathematical statistics functions + .. moduleauthor:: Steven D'Aprano .. sectionauthor:: Steven D'Aprano .. versionadded:: 3.4 +**Source code:** :source:`Lib/statistics.py` + .. testsetup:: * from statistics import * __name__ = '' -**Source code:** :source:`Lib/statistics.py` - -------------- This module provides functions for calculating mathematical statistics of diff --git a/Doc/library/stringprep.rst b/Doc/library/stringprep.rst index fc890cb..e7fae56 100644 --- a/Doc/library/stringprep.rst +++ b/Doc/library/stringprep.rst @@ -3,9 +3,13 @@ .. module:: stringprep :synopsis: String preparation, as per RFC 3453 + .. moduleauthor:: Martin v. Löwis .. sectionauthor:: Martin v. Löwis +**Source code:** :source:`Lib/stringprep.py` + +-------------- When identifying things (such as host names) in the internet, it is often necessary to compare such identifications for "equality". Exactly how this diff --git a/Doc/library/struct.rst b/Doc/library/struct.rst index e757047..ae2e38f 100644 --- a/Doc/library/struct.rst +++ b/Doc/library/struct.rst @@ -4,10 +4,14 @@ .. module:: struct :synopsis: Interpret bytes as packed binary data. +**Source code:** :source:`Lib/struct.py` + .. index:: pair: C; structures triple: packing; binary; data +-------------- + This module performs conversions between Python values and C structs represented as Python :class:`bytes` objects. This can be used in handling binary data stored in files or from network connections, among other sources. It uses diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index 67bee40..f469107 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -3,9 +3,13 @@ .. module:: subprocess :synopsis: Subprocess management. + .. moduleauthor:: Peter Åstrand .. sectionauthor:: Peter Åstrand +**Source code:** :source:`Lib/subprocess.py` + +-------------- The :mod:`subprocess` module allows you to spawn new processes, connect to their input/output/error pipes, and obtain their return codes. This module intends to diff --git a/Doc/library/sunau.rst b/Doc/library/sunau.rst index bd37ee2..d0fd0a3 100644 --- a/Doc/library/sunau.rst +++ b/Doc/library/sunau.rst @@ -3,6 +3,7 @@ .. module:: sunau :synopsis: Provide an interface to the Sun AU sound format. + .. sectionauthor:: Moshe Zadka **Source code:** :source:`Lib/sunau.py` diff --git a/Doc/library/symbol.rst b/Doc/library/symbol.rst index ef9ef1e..4499693 100644 --- a/Doc/library/symbol.rst +++ b/Doc/library/symbol.rst @@ -3,6 +3,7 @@ .. module:: symbol :synopsis: Constants representing internal nodes of the parse tree. + .. sectionauthor:: Fred L. Drake, Jr. **Source code:** :source:`Lib/symbol.py` diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 4f94124..9f70a13 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -4,6 +4,7 @@ .. module:: sys :synopsis: Access system-specific parameters and functions. +-------------- This module provides access to some variables used or maintained by the interpreter and to functions that interact strongly with the interpreter. It is diff --git a/Doc/library/sysconfig.rst b/Doc/library/sysconfig.rst index 535ac54..0b0df9b 100644 --- a/Doc/library/sysconfig.rst +++ b/Doc/library/sysconfig.rst @@ -3,16 +3,17 @@ .. module:: sysconfig :synopsis: Python's configuration information + .. moduleauthor:: Tarek Ziadé .. sectionauthor:: Tarek Ziadé -.. index:: - single: configuration information - .. versionadded:: 3.2 **Source code:** :source:`Lib/sysconfig.py` +.. index:: + single: configuration information + -------------- The :mod:`sysconfig` module provides access to Python's configuration diff --git a/Doc/library/syslog.rst b/Doc/library/syslog.rst index 6e90dc0..af3fb9b 100644 --- a/Doc/library/syslog.rst +++ b/Doc/library/syslog.rst @@ -5,6 +5,7 @@ :platform: Unix :synopsis: An interface to the Unix syslog library routines. +-------------- This module provides an interface to the Unix ``syslog`` library routines. Refer to the Unix manual pages for a detailed description of the ``syslog`` diff --git a/Doc/library/tabnanny.rst b/Doc/library/tabnanny.rst index 4f3e705..1edb0fb 100644 --- a/Doc/library/tabnanny.rst +++ b/Doc/library/tabnanny.rst @@ -4,6 +4,7 @@ .. module:: tabnanny :synopsis: Tool for detecting white space related problems in Python source files in a directory tree. + .. moduleauthor:: Tim Peters .. sectionauthor:: Peter Funk diff --git a/Doc/library/tarfile.rst b/Doc/library/tarfile.rst index b49da47..32d69bf 100644 --- a/Doc/library/tarfile.rst +++ b/Doc/library/tarfile.rst @@ -4,7 +4,6 @@ .. module:: tarfile :synopsis: Read and write tar-format archive files. - .. moduleauthor:: Lars Gustäbel .. sectionauthor:: Lars Gustäbel diff --git a/Doc/library/telnetlib.rst b/Doc/library/telnetlib.rst index 4040f72..b950e41 100644 --- a/Doc/library/telnetlib.rst +++ b/Doc/library/telnetlib.rst @@ -3,13 +3,13 @@ .. module:: telnetlib :synopsis: Telnet client class. + .. sectionauthor:: Skip Montanaro +**Source code:** :source:`Lib/telnetlib.py` .. index:: single: protocol; Telnet -**Source code:** :source:`Lib/telnetlib.py` - -------------- The :mod:`telnetlib` module provides a :class:`Telnet` class that implements the diff --git a/Doc/library/tempfile.rst b/Doc/library/tempfile.rst index 486c18d..665261f 100644 --- a/Doc/library/tempfile.rst +++ b/Doc/library/tempfile.rst @@ -1,19 +1,17 @@ :mod:`tempfile` --- Generate temporary files and directories ============================================================ -.. sectionauthor:: Zack Weinberg - - .. module:: tempfile :synopsis: Generate temporary files and directories. +.. sectionauthor:: Zack Weinberg + +**Source code:** :source:`Lib/tempfile.py` .. index:: pair: temporary; file name pair: temporary; file -**Source code:** :source:`Lib/tempfile.py` - -------------- This module creates temporary files and directories. It works on all diff --git a/Doc/library/termios.rst b/Doc/library/termios.rst index d225d94..ad6a9f7 100644 --- a/Doc/library/termios.rst +++ b/Doc/library/termios.rst @@ -5,11 +5,12 @@ :platform: Unix :synopsis: POSIX style tty control. - .. index:: pair: POSIX; I/O control pair: tty; I/O control +-------------- + This module provides an interface to the POSIX calls for tty I/O control. For a complete description of these calls, see :manpage:`termios(2)` Unix manual page. It is only available for those Unix versions that support POSIX diff --git a/Doc/library/test.rst b/Doc/library/test.rst index a5ce2ca..2ea9c27 100644 --- a/Doc/library/test.rst +++ b/Doc/library/test.rst @@ -3,6 +3,7 @@ .. module:: test :synopsis: Regression tests package containing the testing suite for Python. + .. sectionauthor:: Brett Cannon .. note:: @@ -12,6 +13,7 @@ mentioned here can change or be removed without notice between releases of Python. +-------------- The :mod:`test` package contains all regression tests for Python as well as the modules :mod:`test.support` and :mod:`test.regrtest`. diff --git a/Doc/library/textwrap.rst b/Doc/library/textwrap.rst index 9fe7a35..438007d 100644 --- a/Doc/library/textwrap.rst +++ b/Doc/library/textwrap.rst @@ -3,6 +3,7 @@ .. module:: textwrap :synopsis: Text wrapping and filling + .. moduleauthor:: Greg Ward .. sectionauthor:: Greg Ward diff --git a/Doc/library/time.rst b/Doc/library/time.rst index 8b53bbb..e6626f2 100644 --- a/Doc/library/time.rst +++ b/Doc/library/time.rst @@ -4,6 +4,7 @@ .. module:: time :synopsis: Time access and conversions. +-------------- This module provides various time-related functions. For related functionality, see also the :mod:`datetime` and :mod:`calendar` modules. diff --git a/Doc/library/timeit.rst b/Doc/library/timeit.rst index 16baf91..57a4834 100644 --- a/Doc/library/timeit.rst +++ b/Doc/library/timeit.rst @@ -4,13 +4,12 @@ .. module:: timeit :synopsis: Measure the execution time of small code snippets. +**Source code:** :source:`Lib/timeit.py` .. index:: single: Benchmarking single: Performance -**Source code:** :source:`Lib/timeit.py` - -------------- This module provides a simple way to time small bits of Python code. It has both diff --git a/Doc/library/tkinter.rst b/Doc/library/tkinter.rst index 5393124..130aafe 100644 --- a/Doc/library/tkinter.rst +++ b/Doc/library/tkinter.rst @@ -3,8 +3,12 @@ .. module:: tkinter :synopsis: Interface to Tcl/Tk for graphical user interfaces + .. moduleauthor:: Guido van Rossum +**Source code:** :source:`Lib/tkinter/__init__.py` + +-------------- The :mod:`tkinter` package ("Tk interface") is the standard Python interface to the Tk GUI toolkit. Both Tk and :mod:`tkinter` are available on most Unix diff --git a/Doc/library/tkinter.scrolledtext.rst b/Doc/library/tkinter.scrolledtext.rst index 520970f..138720e 100644 --- a/Doc/library/tkinter.scrolledtext.rst +++ b/Doc/library/tkinter.scrolledtext.rst @@ -4,8 +4,12 @@ .. module:: tkinter.scrolledtext :platform: Tk :synopsis: Text widget with a vertical scroll bar. + .. sectionauthor:: Fred L. Drake, Jr. +**Source code:** :source:`Lib/tkinter/scrolledtext.py` + +-------------- The :mod:`tkinter.scrolledtext` module provides a class of the same name which implements a basic text widget which has a vertical scroll bar configured to do diff --git a/Doc/library/tkinter.tix.rst b/Doc/library/tkinter.tix.rst index d66f595..41f20dd 100644 --- a/Doc/library/tkinter.tix.rst +++ b/Doc/library/tkinter.tix.rst @@ -3,11 +3,15 @@ .. module:: tkinter.tix :synopsis: Tk Extension Widgets for Tkinter + .. sectionauthor:: Mike Clarkson +**Source code:** :source:`Lib/tkinter/tix.py` .. index:: single: Tix +-------------- + The :mod:`tkinter.tix` (Tk Interface Extension) module provides an additional rich set of widgets. Although the standard Tk library has many useful widgets, they are far from complete. The :mod:`tkinter.tix` library provides most of the diff --git a/Doc/library/tkinter.ttk.rst b/Doc/library/tkinter.ttk.rst index 7448525..dbb5bd2 100644 --- a/Doc/library/tkinter.ttk.rst +++ b/Doc/library/tkinter.ttk.rst @@ -3,11 +3,15 @@ .. module:: tkinter.ttk :synopsis: Tk themed widget set + .. sectionauthor:: Guilherme Polo +**Source code:** :source:`Lib/tkinter/ttk.py` .. index:: single: ttk +-------------- + The :mod:`tkinter.ttk` module provides access to the Tk themed widget set, introduced in Tk 8.5. If Python has not been compiled against Tk 8.5, this module can still be accessed if *Tile* has been installed. The former diff --git a/Doc/library/token.rst b/Doc/library/token.rst index c6bfa35..116efca 100644 --- a/Doc/library/token.rst +++ b/Doc/library/token.rst @@ -3,6 +3,7 @@ .. module:: token :synopsis: Constants representing terminal nodes of the parse tree. + .. sectionauthor:: Fred L. Drake, Jr. **Source code:** :source:`Lib/token.py` diff --git a/Doc/library/tokenize.rst b/Doc/library/tokenize.rst index 272e370..ff55aac 100644 --- a/Doc/library/tokenize.rst +++ b/Doc/library/tokenize.rst @@ -3,6 +3,7 @@ .. module:: tokenize :synopsis: Lexical scanner for Python source code. + .. moduleauthor:: Ka Ping Yee .. sectionauthor:: Fred L. Drake, Jr. diff --git a/Doc/library/traceback.rst b/Doc/library/traceback.rst index 5459daa..6ec9ada 100644 --- a/Doc/library/traceback.rst +++ b/Doc/library/traceback.rst @@ -4,6 +4,9 @@ .. module:: traceback :synopsis: Print or retrieve a stack traceback. +**Source code:** :source:`Lib/traceback.py` + +-------------- This module provides a standard interface to extract, format and print stack traces of Python programs. It exactly mimics the behavior of the Python diff --git a/Doc/library/tracemalloc.rst b/Doc/library/tracemalloc.rst index 5feb2d9..3a0b1e0 100644 --- a/Doc/library/tracemalloc.rst +++ b/Doc/library/tracemalloc.rst @@ -6,6 +6,10 @@ .. versionadded:: 3.4 +**Source code:** :source:`Lib/tracemalloc.py` + +-------------- + The tracemalloc module is a debug tool to trace memory blocks allocated by Python. It provides the following information: diff --git a/Doc/library/tty.rst b/Doc/library/tty.rst index d13c6f9..b30bc3c 100644 --- a/Doc/library/tty.rst +++ b/Doc/library/tty.rst @@ -4,9 +4,13 @@ .. module:: tty :platform: Unix :synopsis: Utility functions that perform common terminal control operations. + .. moduleauthor:: Steen Lumholt .. sectionauthor:: Moshe Zadka +**Source code:** :source:`Lib/tty.py` + +-------------- The :mod:`tty` module defines functions for putting the tty into cbreak and raw modes. diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst index 30dd6ef..e4a82ea 100644 --- a/Doc/library/turtle.rst +++ b/Doc/library/turtle.rst @@ -4,13 +4,18 @@ .. module:: turtle :synopsis: An educational framework for simple graphics applications + .. sectionauthor:: Gregor Lingl +**Source code:** :source:`Lib/turtle.py` + .. testsetup:: default from turtle import * turtle = Turtle() +-------------- + Introduction ============ diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst index 25d7794..731e2ec 100644 --- a/Doc/library/typing.rst +++ b/Doc/library/typing.rst @@ -4,10 +4,10 @@ .. module:: typing :synopsis: Support for type hints (see PEP 484). -**Source code:** :source:`Lib/typing.py` - .. versionadded:: 3.5 +**Source code:** :source:`Lib/typing.py` + -------------- This module supports type hints as specified by :pep:`484`. The most diff --git a/Doc/library/unicodedata.rst b/Doc/library/unicodedata.rst index 1430d9b..6cd8132 100644 --- a/Doc/library/unicodedata.rst +++ b/Doc/library/unicodedata.rst @@ -3,16 +3,18 @@ .. module:: unicodedata :synopsis: Access the Unicode Database. + .. moduleauthor:: Marc-André Lemburg .. sectionauthor:: Marc-André Lemburg .. sectionauthor:: Martin v. Löwis - .. index:: single: Unicode single: character pair: Unicode; database +-------------- + This module provides access to the Unicode Character Database (UCD) which defines character properties for all Unicode characters. The data contained in this database is compiled from the `UCD version 8.0.0 diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst index 929cead..5c9177a 100644 --- a/Doc/library/unittest.mock.rst +++ b/Doc/library/unittest.mock.rst @@ -4,11 +4,16 @@ .. module:: unittest.mock :synopsis: Mock object library. + .. moduleauthor:: Michael Foord .. currentmodule:: unittest.mock .. versionadded:: 3.3 +**Source code:** :source:`Lib/unittest/mock.py` + +-------------- + :mod:`unittest.mock` is a library for testing in Python. It allows you to replace parts of your system under test with mock objects and make assertions about how they have been used. @@ -32,8 +37,6 @@ used by many mocking frameworks. There is a backport of :mod:`unittest.mock` for earlier versions of Python, available as `mock on PyPI `_. -**Source code:** :source:`Lib/unittest/mock.py` - Quick Guide ----------- diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst index 8482f20..0fc02c4 100644 --- a/Doc/library/unittest.rst +++ b/Doc/library/unittest.rst @@ -3,11 +3,16 @@ .. module:: unittest :synopsis: Unit testing framework for Python. + .. moduleauthor:: Steve Purcell .. sectionauthor:: Steve Purcell .. sectionauthor:: Fred L. Drake, Jr. .. sectionauthor:: Raymond Hettinger +**Source code:** :source:`Lib/unittest/__init__.py` + +-------------- + (If you are already familiar with the basic concepts of testing, you might want to skip to :ref:`the list of assert methods `.) diff --git a/Doc/library/urllib.error.rst b/Doc/library/urllib.error.rst index f7f0c97..5517b04 100644 --- a/Doc/library/urllib.error.rst +++ b/Doc/library/urllib.error.rst @@ -3,9 +3,13 @@ .. module:: urllib.error :synopsis: Exception classes raised by urllib.request. + .. moduleauthor:: Jeremy Hylton .. sectionauthor:: Senthil Kumaran +**Source code:** :source:`Lib/urllib/error.py` + +-------------- The :mod:`urllib.error` module defines the exception classes for exceptions raised by :mod:`urllib.request`. The base exception class is :exc:`URLError`. diff --git a/Doc/library/urllib.parse.rst b/Doc/library/urllib.parse.rst index 9eb0a93..c6de230 100644 --- a/Doc/library/urllib.parse.rst +++ b/Doc/library/urllib.parse.rst @@ -4,6 +4,7 @@ .. module:: urllib.parse :synopsis: Parse URLs into or assemble them from components. +**Source code:** :source:`Lib/urllib/parse.py` .. index:: single: WWW @@ -12,8 +13,6 @@ pair: URL; parsing pair: relative; URL -**Source code:** :source:`Lib/urllib/parse.py` - -------------- This module defines a standard interface to break Uniform Resource Locator (URL) diff --git a/Doc/library/urllib.request.rst b/Doc/library/urllib.request.rst index 86f4989..1338906 100644 --- a/Doc/library/urllib.request.rst +++ b/Doc/library/urllib.request.rst @@ -3,10 +3,14 @@ .. module:: urllib.request :synopsis: Extensible library for opening URLs. + .. moduleauthor:: Jeremy Hylton .. sectionauthor:: Moshe Zadka .. sectionauthor:: Senthil Kumaran +**Source code:** :source:`Lib/urllib/request.py` + +-------------- The :mod:`urllib.request` module defines functions and classes which help in opening URLs (mostly HTTP) in a complex world --- basic and digest diff --git a/Doc/library/urllib.robotparser.rst b/Doc/library/urllib.robotparser.rst index f179de2..ba701c3 100644 --- a/Doc/library/urllib.robotparser.rst +++ b/Doc/library/urllib.robotparser.rst @@ -4,8 +4,10 @@ .. module:: urllib.robotparser :synopsis: Load a robots.txt file and answer questions about fetchability of other URLs. + .. sectionauthor:: Skip Montanaro +**Source code:** :source:`Lib/urllib/robotparser.py` .. index:: single: WWW @@ -13,6 +15,8 @@ single: URL single: robots.txt +-------------- + This module provides a single class, :class:`RobotFileParser`, which answers questions about whether or not a particular user agent can fetch a URL on the Web site that published the :file:`robots.txt` file. For more details on the diff --git a/Doc/library/urllib.rst b/Doc/library/urllib.rst index 8e308bc..624e164 100644 --- a/Doc/library/urllib.rst +++ b/Doc/library/urllib.rst @@ -3,6 +3,10 @@ .. module:: urllib +**Source code:** :source:`Lib/urllib/` + +-------------- + ``urllib`` is a package that collects several modules for working with URLs: * :mod:`urllib.request` for opening and reading URLs diff --git a/Doc/library/uu.rst b/Doc/library/uu.rst index d61c178..33fb36d 100644 --- a/Doc/library/uu.rst +++ b/Doc/library/uu.rst @@ -3,6 +3,7 @@ .. module:: uu :synopsis: Encode and decode files in uuencode format. + .. moduleauthor:: Lance Ellinghouse **Source code:** :source:`Lib/uu.py` diff --git a/Doc/library/uuid.rst b/Doc/library/uuid.rst index 7dc46ac..53cbd6c 100644 --- a/Doc/library/uuid.rst +++ b/Doc/library/uuid.rst @@ -6,6 +6,9 @@ .. moduleauthor:: Ka-Ping Yee .. sectionauthor:: George Yoshida +**Source code:** :source:`Lib/uuid.py` + +-------------- This module provides immutable :class:`UUID` objects (the :class:`UUID` class) and the functions :func:`uuid1`, :func:`uuid3`, :func:`uuid4`, :func:`uuid5` for diff --git a/Doc/library/venv.rst b/Doc/library/venv.rst index acd1443..af4a6d1 100644 --- a/Doc/library/venv.rst +++ b/Doc/library/venv.rst @@ -3,15 +3,15 @@ .. module:: venv :synopsis: Creation of virtual environments. + .. moduleauthor:: Vinay Sajip .. sectionauthor:: Vinay Sajip - -.. index:: pair: Environments; virtual - .. versionadded:: 3.3 -**Source code:** :source:`Lib/venv` +**Source code:** :source:`Lib/venv/` + +.. index:: pair: Environments; virtual -------------- diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst index 037f11d..5212131 100644 --- a/Doc/library/warnings.rst +++ b/Doc/library/warnings.rst @@ -1,13 +1,13 @@ :mod:`warnings` --- Warning control =================================== -.. index:: single: warnings - .. module:: warnings :synopsis: Issue warning messages and control their disposition. **Source code:** :source:`Lib/warnings.py` +.. index:: single: warnings + -------------- Warning messages are typically issued in situations where it is useful to alert diff --git a/Doc/library/wave.rst b/Doc/library/wave.rst index ab64978..7144379 100644 --- a/Doc/library/wave.rst +++ b/Doc/library/wave.rst @@ -3,6 +3,7 @@ .. module:: wave :synopsis: Provide an interface to the WAV sound format. + .. sectionauthor:: Moshe Zadka .. Documentations stolen from comments in file. diff --git a/Doc/library/weakref.rst b/Doc/library/weakref.rst index 01dabc9..0470bd1 100644 --- a/Doc/library/weakref.rst +++ b/Doc/library/weakref.rst @@ -3,6 +3,7 @@ .. module:: weakref :synopsis: Support for weak references and weak dictionaries. + .. moduleauthor:: Fred L. Drake, Jr. .. moduleauthor:: Neil Schemenauer .. moduleauthor:: Martin von Löwis diff --git a/Doc/library/webbrowser.rst b/Doc/library/webbrowser.rst index 17c6dc3..85d3636 100644 --- a/Doc/library/webbrowser.rst +++ b/Doc/library/webbrowser.rst @@ -3,6 +3,7 @@ .. module:: webbrowser :synopsis: Easy-to-use controller for Web browsers. + .. moduleauthor:: Fred L. Drake, Jr. .. sectionauthor:: Fred L. Drake, Jr. diff --git a/Doc/library/winreg.rst b/Doc/library/winreg.rst index 94378b2..52d591a 100644 --- a/Doc/library/winreg.rst +++ b/Doc/library/winreg.rst @@ -4,8 +4,10 @@ .. module:: winreg :platform: Windows :synopsis: Routines and objects for manipulating the Windows registry. + .. sectionauthor:: Mark Hammond +-------------- These functions expose the Windows registry API to Python. Instead of using an integer as the registry handle, a :ref:`handle object ` is used diff --git a/Doc/library/winsound.rst b/Doc/library/winsound.rst index 61f34cd..d2c4210 100644 --- a/Doc/library/winsound.rst +++ b/Doc/library/winsound.rst @@ -4,9 +4,11 @@ .. module:: winsound :platform: Windows :synopsis: Access to the sound-playing machinery for Windows. + .. moduleauthor:: Toby Dickenson .. sectionauthor:: Fred L. Drake, Jr. +-------------- The :mod:`winsound` module provides access to the basic sound-playing machinery provided by Windows platforms. It includes functions and several constants. diff --git a/Doc/library/wsgiref.rst b/Doc/library/wsgiref.rst index 3253f48..aad27a8 100644 --- a/Doc/library/wsgiref.rst +++ b/Doc/library/wsgiref.rst @@ -3,9 +3,11 @@ .. module:: wsgiref :synopsis: WSGI Utilities and Reference Implementation. + .. moduleauthor:: Phillip J. Eby .. sectionauthor:: Phillip J. Eby +-------------- The Web Server Gateway Interface (WSGI) is a standard interface between web server software and web applications written in Python. Having a standard diff --git a/Doc/library/xdrlib.rst b/Doc/library/xdrlib.rst index 5c7dfa4..42a03a4 100644 --- a/Doc/library/xdrlib.rst +++ b/Doc/library/xdrlib.rst @@ -4,13 +4,12 @@ .. module:: xdrlib :synopsis: Encoders and decoders for the External Data Representation (XDR). +**Source code:** :source:`Lib/xdrlib.py` .. index:: single: XDR single: External Data Representation -**Source code:** :source:`Lib/xdrlib.py` - -------------- The :mod:`xdrlib` module supports the External Data Representation Standard as diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst index a8c1f1d..e1042e7 100644 --- a/Doc/library/xml.dom.minidom.rst +++ b/Doc/library/xml.dom.minidom.rst @@ -3,6 +3,7 @@ .. module:: xml.dom.minidom :synopsis: Minimal Document Object Model (DOM) implementation. + .. moduleauthor:: Paul Prescod .. sectionauthor:: Paul Prescod .. sectionauthor:: Martin v. Löwis diff --git a/Doc/library/xml.dom.pulldom.rst b/Doc/library/xml.dom.pulldom.rst index 98329a2..c3339ed 100644 --- a/Doc/library/xml.dom.pulldom.rst +++ b/Doc/library/xml.dom.pulldom.rst @@ -3,6 +3,7 @@ .. module:: xml.dom.pulldom :synopsis: Support for building partial DOM trees from SAX events. + .. moduleauthor:: Paul Prescod **Source code:** :source:`Lib/xml/dom/pulldom.py` diff --git a/Doc/library/xml.dom.rst b/Doc/library/xml.dom.rst index 13e0d1b..b037ff6 100644 --- a/Doc/library/xml.dom.rst +++ b/Doc/library/xml.dom.rst @@ -3,9 +3,13 @@ .. module:: xml.dom :synopsis: Document Object Model API for Python. + .. sectionauthor:: Paul Prescod .. sectionauthor:: Martin v. Löwis +**Source code:** :source:`Lib/xml/dom/__init__.py` + +-------------- The Document Object Model, or "DOM," is a cross-language API from the World Wide Web Consortium (W3C) for accessing and modifying XML documents. A DOM diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst index f5cdf03..99d7e8b 100644 --- a/Doc/library/xml.etree.elementtree.rst +++ b/Doc/library/xml.etree.elementtree.rst @@ -3,8 +3,13 @@ .. module:: xml.etree.ElementTree :synopsis: Implementation of the ElementTree API. + .. moduleauthor:: Fredrik Lundh +**Source code:** :source:`Lib/xml/etree/ElementTree.py` + +-------------- + The :mod:`xml.etree.ElementTree` module implements a simple and efficient API for parsing and creating XML data. diff --git a/Doc/library/xml.rst b/Doc/library/xml.rst index 0bcf581..3c2fc89 100644 --- a/Doc/library/xml.rst +++ b/Doc/library/xml.rst @@ -5,9 +5,13 @@ XML Processing Modules .. module:: xml :synopsis: Package containing XML processing modules + .. sectionauthor:: Christian Heimes .. sectionauthor:: Georg Brandl +**Source code:** :source:`Lib/xml/` + +-------------- Python's interfaces for processing XML are grouped in the ``xml`` package. diff --git a/Doc/library/xml.sax.handler.rst b/Doc/library/xml.sax.handler.rst index 0fb3341..ae0877c 100644 --- a/Doc/library/xml.sax.handler.rst +++ b/Doc/library/xml.sax.handler.rst @@ -3,9 +3,13 @@ .. module:: xml.sax.handler :synopsis: Base classes for SAX event handlers. + .. moduleauthor:: Lars Marius Garshol .. sectionauthor:: Martin v. Löwis +**Source code:** :source:`Lib/xml/sax/handler.py` + +-------------- The SAX API defines four kinds of handlers: content handlers, DTD handlers, error handlers, and entity resolvers. Applications normally only need to diff --git a/Doc/library/xml.sax.reader.rst b/Doc/library/xml.sax.reader.rst index 47d23d6..c368fc2 100644 --- a/Doc/library/xml.sax.reader.rst +++ b/Doc/library/xml.sax.reader.rst @@ -3,9 +3,13 @@ .. module:: xml.sax.xmlreader :synopsis: Interface which SAX-compliant XML parsers must implement. + .. moduleauthor:: Lars Marius Garshol .. sectionauthor:: Martin v. Löwis +**Source code:** :source:`Lib/xml/sax/xmlreader.py` + +-------------- SAX parsers implement the :class:`XMLReader` interface. They are implemented in a Python module, which must provide a function :func:`create_parser`. This diff --git a/Doc/library/xml.sax.rst b/Doc/library/xml.sax.rst index 55f9799..78d6633 100644 --- a/Doc/library/xml.sax.rst +++ b/Doc/library/xml.sax.rst @@ -3,10 +3,14 @@ .. module:: xml.sax :synopsis: Package containing SAX2 base classes and convenience functions. + .. moduleauthor:: Lars Marius Garshol .. sectionauthor:: Fred L. Drake, Jr. .. sectionauthor:: Martin v. Löwis +**Source code:** :source:`Lib/xml/sax/__init__.py` + +-------------- The :mod:`xml.sax` package provides a number of modules which implement the Simple API for XML (SAX) interface for Python. The package itself provides the diff --git a/Doc/library/xml.sax.utils.rst b/Doc/library/xml.sax.utils.rst index 14cf078..538b798 100644 --- a/Doc/library/xml.sax.utils.rst +++ b/Doc/library/xml.sax.utils.rst @@ -3,9 +3,13 @@ .. module:: xml.sax.saxutils :synopsis: Convenience functions and classes for use with SAX. + .. moduleauthor:: Lars Marius Garshol .. sectionauthor:: Martin v. Löwis +**Source code:** :source:`Lib/xml/sax/saxutils.py` + +-------------- The module :mod:`xml.sax.saxutils` contains a number of classes and functions that are commonly useful when creating SAX applications, either in direct use, diff --git a/Doc/library/xmlrpc.client.rst b/Doc/library/xmlrpc.client.rst index c83ecae..e7916d2 100644 --- a/Doc/library/xmlrpc.client.rst +++ b/Doc/library/xmlrpc.client.rst @@ -3,15 +3,15 @@ .. module:: xmlrpc.client :synopsis: XML-RPC client access. + .. moduleauthor:: Fredrik Lundh .. sectionauthor:: Eric S. Raymond +**Source code:** :source:`Lib/xmlrpc/client.py` .. XXX Not everything is documented yet. It might be good to describe Marshaller, Unmarshaller, getparser and Transport. -**Source code:** :source:`Lib/xmlrpc/client.py` - -------------- XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP(S) as a diff --git a/Doc/library/xmlrpc.server.rst b/Doc/library/xmlrpc.server.rst index 680db41..ad1e812 100644 --- a/Doc/library/xmlrpc.server.rst +++ b/Doc/library/xmlrpc.server.rst @@ -3,6 +3,7 @@ .. module:: xmlrpc.server :synopsis: Basic XML-RPC server implementations. + .. moduleauthor:: Brian Quinlan .. sectionauthor:: Fred L. Drake, Jr. diff --git a/Doc/library/zipapp.rst b/Doc/library/zipapp.rst index 265e62d..7c7767f 100644 --- a/Doc/library/zipapp.rst +++ b/Doc/library/zipapp.rst @@ -4,14 +4,13 @@ .. module:: zipapp :synopsis: Manage executable python zip archives - -.. index:: - single: Executable Zip Files - .. versionadded:: 3.5 **Source code:** :source:`Lib/zipapp.py` +.. index:: + single: Executable Zip Files + -------------- This module provides tools to manage the creation of zip files containing diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst index 9b0d18a..b421ea5 100644 --- a/Doc/library/zipfile.rst +++ b/Doc/library/zipfile.rst @@ -3,6 +3,7 @@ .. module:: zipfile :synopsis: Read and write ZIP-format archive files. + .. moduleauthor:: James C. Ahlstrom .. sectionauthor:: James C. Ahlstrom diff --git a/Doc/library/zipimport.rst b/Doc/library/zipimport.rst index 58e0b7c..0a0f175 100644 --- a/Doc/library/zipimport.rst +++ b/Doc/library/zipimport.rst @@ -3,8 +3,10 @@ .. module:: zipimport :synopsis: support for importing Python modules from ZIP archives. + .. moduleauthor:: Just van Rossum +-------------- This module adds the ability to import Python modules (:file:`\*.py`, :file:`\*.py[co]`) and packages from ZIP-format archives. It is usually not diff --git a/Doc/library/zlib.rst b/Doc/library/zlib.rst index b7ca558..1de7bae 100644 --- a/Doc/library/zlib.rst +++ b/Doc/library/zlib.rst @@ -5,6 +5,7 @@ :synopsis: Low-level interface to compression and decompression routines compatible with gzip. +-------------- For applications that require data compression, the functions in this module allow compression and decompression, using the zlib library. The zlib library diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index ec0b218..6f739c4 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -75,7 +75,9 @@

25.5. IDLE

-

IDLE is Python’s Integrated Development and Learning Environment.

+

Source code: Lib/idlelib/

+
+

IDLE is Python’s Integrated Development and Learning Environment.

IDLE has the following features:

  • coded in 100% pure Python, using the tkinter GUI toolkit
    • @@ -701,7 +703,7 @@ are currently:

    The Python Software Foundation is a non-profit corporation. Please donate.
    - Last updated on May 02, 2016. + Last updated on Jun 11, 2016. Found a bug?
    Created using Sphinx 1.3.3. diff --git a/Misc/ACKS b/Misc/ACKS index 262c647..001373b 100644 --- a/Misc/ACKS +++ b/Misc/ACKS @@ -824,6 +824,7 @@ Soren Larsen Amos Latteier Piers Lauder Ben Laurie +Yoni Lavi Simon Law Julia Lawall Chris Lawrence diff --git a/Misc/NEWS b/Misc/NEWS index 1ed87ac..f59ed1e 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -1139,6 +1139,9 @@ IDLE Documentation ------------- +- Issue #22558: Add remaining doc links to source code for Python-coded modules. + Patch by Yoni Lavi. + - Issue #12067: Rewrite Comparisons section in the Expressions chapter of the language reference. Some of the details of comparing mixed types were incorrect or ambiguous. NotImplemented is only relevant at a lower level -- cgit v0.12