diff --git a/Doc/lib/libcmd.tex b/Doc/lib/libcmd.tex index 83e5ff8549f..37e08a2933f 100644 --- a/Doc/lib/libcmd.tex +++ b/Doc/lib/libcmd.tex @@ -1,10 +1,9 @@ \section{\module{cmd} --- - Build line-oriented command interpreters.} + Support for line-oriented command interpreters} + \declaremodule{standard}{cmd} \sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com} - -\modulesynopsis{Build line-oriented command interpreters; this is used -by module \module{pdb}.} +\modulesynopsis{Build line-oriented command interpreters.} The \class{Cmd} class provides a simple framework for writing diff --git a/Doc/lib/libcurses.tex b/Doc/lib/libcurses.tex index e3e94ad1fda..d5a8c2b7aa2 100644 --- a/Doc/lib/libcurses.tex +++ b/Doc/lib/libcurses.tex @@ -1,10 +1,11 @@ \section{\module{curses} --- - Screen painting and input handling for character-cell terminals} + Terminal handling for character-cell displays} \declaremodule{standard}{curses} \sectionauthor{Moshe Zadka}{mzadka@geocities.com} \sectionauthor{Eric Raymond}{esr@thyrsus.com} -\modulesynopsis{An interface to the curses library.} +\modulesynopsis{An interface to the curses library, providing portable + terminal handling.} \versionchanged[Added support for the \code{ncurses} library and converted to a package]{1.6} diff --git a/Doc/lib/libdis.tex b/Doc/lib/libdis.tex index f31c9f47f65..2dd74bdb620 100644 --- a/Doc/lib/libdis.tex +++ b/Doc/lib/libdis.tex @@ -1,8 +1,9 @@ \section{\module{dis} --- - Disassembler.} -\declaremodule{standard}{dis} + Disassembler for Python byte code} -\modulesynopsis{Disassembler.} +\declaremodule{standard}{dis} +\modulesynopsis{Disassembler for Python byte code, as stored in code + objects and \file{.pyc}/\file{.pyo} files.} The \module{dis} module supports the analysis of Python byte code by diff --git a/Doc/lib/liberrno.tex b/Doc/lib/liberrno.tex index 7e0c1a9b590..c0ce6e8b384 100644 --- a/Doc/lib/liberrno.tex +++ b/Doc/lib/liberrno.tex @@ -1,12 +1,11 @@ \section{\module{errno} --- - Standard errno system symbols.} -\declaremodule{standard}{errno} + Standard errno system symbols} +\declaremodule{standard}{errno} \modulesynopsis{Standard errno system symbols.} - -This module makes available standard errno system symbols. +This module makes available standard \code{errno} system symbols. The value of each symbol is the corresponding integer value. The names and descriptions are borrowed from \file{linux/include/errno.h}, which should be pretty all-inclusive. @@ -21,8 +20,9 @@ To translate a numeric error code to an error message, use \function{os.strerror()}. Of the following list, symbols that are not used on the current -platform are not defined by the module. Symbols available can -include: +platform are not defined by the module. The specific list of defined +symbols is available as \code{errno.errorcode.keys()}. Symbols +available can include: \begin{datadesc}{EPERM} Operation not permitted \end{datadesc} \begin{datadesc}{ENOENT} No such file or directory \end{datadesc} diff --git a/Doc/lib/libgetopt.tex b/Doc/lib/libgetopt.tex index 4f32225f3fc..6731c3220a2 100644 --- a/Doc/lib/libgetopt.tex +++ b/Doc/lib/libgetopt.tex @@ -1,8 +1,9 @@ \section{\module{getopt} --- - Parser for command line options.} -\declaremodule{standard}{getopt} + Parser for command line options} -\modulesynopsis{Parser for command line options.} +\declaremodule{standard}{getopt} +\modulesynopsis{Portable parser for command line options; support both + short and long option names.} This module helps scripts to parse the command line arguments in diff --git a/Doc/lib/libimghdr.tex b/Doc/lib/libimghdr.tex index 54e58014876..2f1ac7d9f0f 100644 --- a/Doc/lib/libimghdr.tex +++ b/Doc/lib/libimghdr.tex @@ -1,8 +1,9 @@ \section{\module{imghdr} --- - Determine the type of an image.} -\declaremodule{standard}{imghdr} + Determine the type of an image} -\modulesynopsis{Determine the type of image contained in a file or byte stream.} +\declaremodule{standard}{imghdr} +\modulesynopsis{Determine the type of image contained in a file or + byte stream.} The \module{imghdr} module determines the type of image contained in a diff --git a/Doc/lib/libnew.tex b/Doc/lib/libnew.tex index 24fc881af15..df7adfbd26f 100644 --- a/Doc/lib/libnew.tex +++ b/Doc/lib/libnew.tex @@ -1,5 +1,5 @@ \section{\module{new} --- - Runtime implementation object creation} + Creation of runtime internal objects} \declaremodule{builtin}{new} \sectionauthor{Moshe Zadka}{mzadka@geocities.com} diff --git a/Doc/lib/libpprint.tex b/Doc/lib/libpprint.tex index 82eb1972528..3ecc7bc0377 100644 --- a/Doc/lib/libpprint.tex +++ b/Doc/lib/libpprint.tex @@ -1,5 +1,5 @@ \section{\module{pprint} --- - Data pretty printer.} + Data pretty printer} \declaremodule{standard}{pprint} \modulesynopsis{Data pretty printer.} diff --git a/Doc/lib/libqueue.tex b/Doc/lib/libqueue.tex index 2bb6a2fdd98..0abed61c838 100644 --- a/Doc/lib/libqueue.tex +++ b/Doc/lib/libqueue.tex @@ -1,11 +1,10 @@ \section{\module{Queue} --- - A synchronized queue class.} + A synchronized queue class} + \declaremodule{standard}{Queue} - \modulesynopsis{A synchronized queue class.} - The \module{Queue} module implements a multi-producer, multi-consumer FIFO queue. It is especially useful in threads programming when information must be exchanged safely between multiple threads. The diff --git a/Doc/lib/libreadline.tex b/Doc/lib/libreadline.tex index f59ddac8b1a..9d0091ab3f9 100644 --- a/Doc/lib/libreadline.tex +++ b/Doc/lib/libreadline.tex @@ -4,7 +4,7 @@ \declaremodule{builtin}{readline} \platform{Unix} \sectionauthor{Skip Montanaro}{skip@mojam.com} -\modulesynopsis{GNU Readline in Python.} +\modulesynopsis{GNU readline support for Python.} The \module{readline} module defines a number of functions used either diff --git a/Doc/lib/librepr.tex b/Doc/lib/librepr.tex index 2a372c8c2cb..8dfd0b44551 100644 --- a/Doc/lib/librepr.tex +++ b/Doc/lib/librepr.tex @@ -1,5 +1,5 @@ \section{\module{repr} --- - Alternate \function{repr()} implementation.} + Alternate \function{repr()} implementation} \sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org} \declaremodule{standard}{repr} diff --git a/Doc/lib/librlcompleter.tex b/Doc/lib/librlcompleter.tex index c0c4db858b8..3ff1cf35c8a 100644 --- a/Doc/lib/librlcompleter.tex +++ b/Doc/lib/librlcompleter.tex @@ -1,10 +1,10 @@ \section{\module{rlcompleter} --- - Completion function for readline} + Completion function for GNU readline} \declaremodule{standard}{rlcompleter} \platform{Unix} \sectionauthor{Moshe Zadka}{mzadka@geocities.com} -\modulesynopsis{Python identifier completion in the readline library.} +\modulesynopsis{Python identifier completion for the GNU readline library.} The \module{rlcompleter} module defines a completion function for the \refmodule{readline} module by completing valid Python identifiers diff --git a/Doc/lib/librotor.tex b/Doc/lib/librotor.tex index 799df83a806..6ed031cfeb3 100644 --- a/Doc/lib/librotor.tex +++ b/Doc/lib/librotor.tex @@ -1,7 +1,7 @@ \section{\module{rotor} --- - Enigma-like encryption and decryption.} -\declaremodule{builtin}{rotor} + Enigma-like encryption and decryption} +\declaremodule{builtin}{rotor} \modulesynopsis{Enigma-like encryption and decryption.} diff --git a/Doc/lib/libsignal.tex b/Doc/lib/libsignal.tex index ce23da16be2..11f07373fa8 100644 --- a/Doc/lib/libsignal.tex +++ b/Doc/lib/libsignal.tex @@ -1,10 +1,10 @@ \section{\module{signal} --- - Set handlers for asynchronous events.} + Set handlers for asynchronous events} + \declaremodule{builtin}{signal} - - \modulesynopsis{Set handlers for asynchronous events.} + This module provides mechanisms to use signal handlers in Python. Some general rules for working with signals and their handlers: diff --git a/Doc/lib/libsndhdr.tex b/Doc/lib/libsndhdr.tex index 43f04ec7cb5..a7f8c6eaaea 100644 --- a/Doc/lib/libsndhdr.tex +++ b/Doc/lib/libsndhdr.tex @@ -1,5 +1,5 @@ \section{\module{sndhdr} --- - Determine type of sound file.} + Determine type of sound file} \declaremodule{standard}{sndhdr} \modulesynopsis{Determine type of a sound file.} diff --git a/Doc/lib/libsocksvr.tex b/Doc/lib/libsocksvr.tex index 120b049e97e..18a2fe8f8a5 100644 --- a/Doc/lib/libsocksvr.tex +++ b/Doc/lib/libsocksvr.tex @@ -1,7 +1,7 @@ \section{\module{SocketServer} --- - A framework for network servers.} -\declaremodule{standard}{SocketServer} + A framework for network servers} +\declaremodule{standard}{SocketServer} \modulesynopsis{A framework for network servers.}