New section header style.

Fix up a few synopses.

Doc/lib/libaifc.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{aifc}}
+\section{\module{aifc} ---
+         Read and write audio files in AIFF or AIFC format.}
 \declaremodule{standard}{aifc}
 
 \modulesynopsis{Read and write audio files in AIFF or AIFC format.}

Doc/lib/libal.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{al}}
+\section{\module{al} ---
+         Audio functions on the SGI.}
 \declaremodule{builtin}{al}
 
 \modulesynopsis{Audio functions on the SGI.}
@@ -161,7 +162,8 @@ Get status information on last error.
 \end{methoddesc}
 
 
-\section{Standard Module \module{AL}}
+\section{\module{AL} ---
+         Constants used with the \module{al} module.}
 \declaremodule{standard}{AL}
 
 \modulesynopsis{Constants used with the \module{al} module.}

Doc/lib/libamoeba.tex

@@ -1,6 +1,7 @@
 \chapter{Amoeba Specific Services}
 
-\section{Built-in Module \module{amoeba}}
+\section{\module{amoeba} ---
+         None}
 \declaremodule{builtin}{amoeba}
 
 \modulesynopsis{None}

Doc/lib/libanydbm.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{anydbm}}
+\section{\module{anydbm} ---
+         Generic interface to DBM-style database modules.}
 \declaremodule{standard}{anydbm}
 
 \modulesynopsis{Generic interface to DBM-style database modules.}
@@ -46,7 +47,8 @@ strings.
 
 
 
-\section{Standard Module \module{dumbdbm}}
+\section{\module{dumbdbm} ---
+         Portable implementation of the simple DBM interface.}
 \declaremodule{standard}{dumbdbm}
 
 \modulesynopsis{Portable implementation of the simple DBM interface.}

Doc/lib/libarray.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{array}}
+\section{\module{array} ---
+         Efficient arrays of uniformly typed numeric values.}
 \declaremodule{builtin}{array}
 
 \modulesynopsis{Efficient arrays of uniformly typed numeric values.}

Doc/lib/libaudioop.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{audioop}}
+\section{\module{audioop} ---
+         Manipulate raw audio data.}
 \declaremodule{builtin}{audioop}
 
 \modulesynopsis{Manipulate raw audio data.}

Doc/lib/libbase64.tex

@@ -1,7 +1,9 @@
-\section{Standard Module \module{base64}}
+\section{\module{base64} ---
+         Encode and decode MIME base64 encoding.}
 \declaremodule{standard}{base64}
 
-\modulesynopsis{Encode/decode binary files using the MIME base64 encoding.}
+\modulesynopsis{Encode and decode files using the MIME base64
+encoding.}
 
 \indexii{base64}{encoding}
 \index{MIME!base64 encoding}

Doc/lib/libbasehttp.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{BaseHTTPServer}}
+\section{\module{BaseHTTPServer} ---
+         Basic HTTP server.}
 \declaremodule{standard}{BaseHTTPServer}
 
 \modulesynopsis{Basic HTTP server (base class for

Doc/lib/libbastion.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{Bastion}}
+\section{\module{Bastion} ---
+         Providing restricted access to objects.}
 \declaremodule{standard}{Bastion}
 
 \modulesynopsis{Providing restricted access to objects.}

Doc/lib/libbinascii.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{binascii}}
+\section{\module{binascii} ---
+         Convert between binary and various ascii-encoded representations.}
 \declaremodule{builtin}{binascii}
 
 \modulesynopsis{Tools for converting between binary and various

Doc/lib/libbinhex.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{binhex}}
+\section{\module{binhex} ---
+         Encode and decode files in binhex4 format.}
 \declaremodule{standard}{binhex}
 
 \modulesynopsis{Encode and decode files in binhex4 format.}

Doc/lib/libbisect.tex

@@ -2,7 +2,8 @@
 % example based on the PyModules FAQ entry by Aaron Watters
 % <arw@pythonpros.com>.
 
-\section{Standard Module \module{bisect}}
+\section{\module{bisect} ---
+         Array bisection algorithms for binary searching.}
 \declaremodule{standard}{bisect}
 
 \modulesynopsis{Array bisection algorithms for binary searching.}

Doc/lib/libbltin.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{__builtin__}}
+\section{\module{__builtin__} ---
+         Built-in functions.}
 \declaremodule[builtin]{builtin}{__builtin__}
 
 \modulesynopsis{The set of built-in functions.}

Doc/lib/libcalendar.tex

@@ -1,6 +1,7 @@
 % This section was contributed by Drew Csillag <drew_csillag@geocities.com>.
 
-\section{Standard Module \module{calendar}}
+\section{\module{calendar} ---
+         Functions that emulate the \UNIX{} \program{cal} program.}
 \declaremodule{standard}{calendar}
 
 \modulesynopsis{Functions that emulate the \UNIX{} \program{cal}

Doc/lib/libcd.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{cd}}
+\section{\module{cd} ---
+         Interface to the CD-ROM on Silicon Graphics systems.}
 \declaremodule{builtin}{cd}
 
 \modulesynopsis{Interface to the CD-ROM on Silicon Graphics systems.}

Doc/lib/libcgi.tex

@@ -1,8 +1,9 @@
-\section{Standard Module \module{cgi}}
+\section{\module{cgi} ---
+         Common Gateway Interface support.}
 \declaremodule{standard}{cgi}
 
-\modulesynopsis{Common Gateway Interface, used to interpret forms in server-side
-scripts.}
+\modulesynopsis{Common Gateway Interface support, used to interpret
+forms in server-side scripts.}
 
 \indexii{WWW}{server}
 \indexii{CGI}{protocol}

Doc/lib/libcmath.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{cmath}}
+\section{\module{cmath} ---
+         Mathematical functions for complex numbers.}
 \declaremodule{builtin}{cmath}
 
 

Doc/lib/libcmd.tex

@@ -1,9 +1,10 @@
-% Documentation by ESR
-\section{Standard Module \module{cmd}}
+\section{\module{cmd} ---
+         Build 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; this is used
+by module \module{pdb}.}
 
 
 The \class{Cmd} class provides a simple framework for writing

Doc/lib/libcode.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{code}}
+\section{\module{code} ---
+         Code object services.}
 \declaremodule{standard}{code}
 
 \modulesynopsis{Code object services.}

Doc/lib/libcommands.tex

@@ -1,7 +1,7 @@
-% Documentation written by Sue Williams.
-
-\section{Standard Module \module{commands}}
+\section{\module{commands} ---
+         Wrapper functions for \function{os.popen()}.}
 \declaremodule{standard}{commands}
+\sectionauthor{Sue Williams}{sbw@provis.com}
 
 \modulesynopsis{Wrapper functions for \function{os.popen()}.}
 

Doc/lib/libcopy.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{copy}}
+\section{\module{copy} ---
+         Shallow and deep copy operations.}
 \declaremodule{standard}{copy}
 
 \modulesynopsis{Shallow and deep copy operations.}

Doc/lib/libcopyreg.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{copy_reg}}
+\section{\module{copy_reg} ---
+         Register \module{pickle} support functions.}
 \declaremodule[copyreg]{standard}{copy_reg}
 
 \modulesynopsis{Register \module{pickle} support functions.}

Doc/lib/libcrypt.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{crypt}}
+\section{\module{crypt} ---
+         The \cfunction{crypt()} function used to check \UNIX{} passwords.}
 \declaremodule{builtin}{crypt}
 
 \modulesynopsis{The \cfunction{crypt()} function used to check \UNIX{} passwords.}

Doc/lib/libdbm.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{dbm}}
+\section{\module{dbm} ---
+         The standard ``database'' interface, based on ndbm.}
 \declaremodule{builtin}{dbm}
 
 \modulesynopsis{The standard ``database'' interface, based on ndbm.}

Doc/lib/libdis.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{dis}}
+\section{\module{dis} ---
+         Disassembler.}
 \declaremodule{standard}{dis}
 
 \modulesynopsis{Disassembler.}

Doc/lib/liberrno.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{errno}}
+\section{\module{errno} ---
+         Standard errno system symbols.}
 \declaremodule{standard}{errno}
 
 \modulesynopsis{Standard errno system symbols.}

Doc/lib/libfcntl.tex

@@ -1,5 +1,6 @@
 % Manual text by Jaap Vermeulen
-\section{Built-in Module \module{fcntl}}
+\section{\module{fcntl} ---
+         The \function{fcntl()} and \function{ioctl()} system calls.}
 \declaremodule{builtin}{fcntl}
 
 \modulesynopsis{The \function{fcntl()} and \function{ioctl()} system calls.}

Doc/lib/libfileinput.tex

@@ -1,10 +1,11 @@
-% Documentation heavily adapted from module docstring.
-
-\section{Standard Module \module{fileinput}}
+\section{\module{fileinput} ---
+         Iteration over lines from multiple input streams.}
 \declaremodule{standard}{fileinput}
+\moduleauthor{Guido van Rossum}{guido@python.org}
+\sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
 
-\modulesynopsis{Perl-like iteration over lines from multiple input streams, with
-``save in place'' capability.}
+\modulesynopsis{Perl-like iteration over lines from multiple input
+streams, with ``save in place'' capability.}
 
 
 This module implements a helper class and functions to quickly write a

Doc/lib/libfl.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{fl}}
+\section{\module{fl} ---
+         FORMS library interface for GUI applications.}
 \declaremodule{builtin}{fl}
 
 \modulesynopsis{FORMS library interface for GUI applications.}
@@ -464,7 +465,8 @@ FORMS objects have these data attributes; see the FORMS documentation:
   \lineiii{automatic}{int (read-only)}{(see FORMS docs)}
 \end{tableiii}
 
-\section{Standard Module \module{FL}}
+\section{\module{FL} ---
+         Constants used with the \module{fl} module.}
 \declaremodule{standard}{FL}
 
 \modulesynopsis{Constants used with the \module{fl} module.}
@@ -481,7 +483,8 @@ import fl
 from FL import *
 \end{verbatim}
 
-\section{Standard Module \module{flp}}
+\section{\module{flp} ---
+         Loading functions for stored FORMS designs.}
 \declaremodule{standard}{flp}
 
 \modulesynopsis{Loading functions for stored FORMS designs.}

Doc/lib/libfm.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{fm}}
+\section{\module{fm} ---
+         \emph{Font Manager} interface for SGI workstations.}
 \declaremodule{builtin}{fm}
 
 \modulesynopsis{\emph{Font Manager} interface for SGI workstations.}

Doc/lib/libfnmatch.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{fnmatch}}
+\section{\module{fnmatch} ---
+         \UNIX{} shell style pathname pattern matching.}
 \declaremodule{standard}{fnmatch}
 
 \modulesynopsis{\UNIX{} shell style pathname pattern matching.}

Doc/lib/libformatter.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{formatter}}
+\section{\module{formatter} ---
+         Generic output formatter and device interface.}
 \declaremodule{standard}{formatter}
 
 \modulesynopsis{Generic output formatter and device interface.}

Doc/lib/libftplib.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{ftplib}}
+\section{\module{ftplib} ---
+         FTP protocol client.}
 \declaremodule{standard}{ftplib}
 
 \modulesynopsis{FTP protocol client (requires sockets).}

Doc/lib/libfuncs.tex

@@ -1,5 +1,4 @@
-\section{Built-in Functions}
-\label{built-in-funcs}
+\section{Built-in Functions \label{built-in-funcs}}
 
 The Python interpreter has a number of functions built into it that
 are always available.  They are listed here in alphabetical order.

Doc/lib/libgdbm.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{gdbm}}
+\section{\module{gdbm} ---
+         GNU's reinterpretation of dbm.}
 \declaremodule{builtin}{gdbm}
 
 \modulesynopsis{GNU's reinterpretation of dbm.}

Doc/lib/libgetopt.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{getopt}}
+\section{\module{getopt} ---
+         Parser for command line options.}
 \declaremodule{standard}{getopt}
 
 \modulesynopsis{Parser for command line options.}

Doc/lib/libgl.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{gl}}
+\section{\module{gl} ---
+         Functions from the Silicon Graphics \emph{Graphics Library}.}
 \declaremodule{builtin}{gl}
 
 \modulesynopsis{Functions from the Silicon Graphics \emph{Graphics Library}.}
@@ -185,7 +186,8 @@ def main():
 main()
 \end{verbatim}
 %
-\section{Standard Module \module{DEVICE}}
+\section{\module{DEVICE} ---
+         Constants used with the \module{gl} module.}
 \declaremodule{standard}{DEVICE}
 
 \modulesynopsis{Constants used with the \module{gl} module.}
@@ -196,7 +198,8 @@ This modules defines the constants used by the Silicon Graphics
 Read the module source file for details.
 
 
-\section{Standard Module \module{GL}}
+\section{\module{GL} ---
+         Constants used with the \module{gl} module.}
 \declaremodule{standard}{GL}
 
 \modulesynopsis{Constants used with the \module{gl} module.}

Doc/lib/libglob.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{glob}}
+\section{\module{glob} ---
+         \UNIX{} shell style pathname pattern expansion.}
 \declaremodule{standard}{glob}
 
 \modulesynopsis{\UNIX{} shell style pathname pattern expansion.}

Doc/lib/libgopherlib.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{gopherlib}}
+\section{\module{gopherlib} ---
+         Gopher protocol client.}
 \declaremodule{standard}{gopherlib}
 
 \modulesynopsis{Gopher protocol client (requires sockets).}

Doc/lib/libgrp.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{grp}}
+\section{\module{grp} ---
+         The group database.}
 \declaremodule{builtin}{grp}
 
 

Doc/lib/libgzip.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{gzip}}
+\section{\module{gzip} ---
+         \program{gzip} compression and decompression using files.}
 \declaremodule{standard}{gzip}
 
 \modulesynopsis{Interfaces for \program{gzip} compression and

Doc/lib/libhtmllib.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{htmllib}}
+\section{\module{htmllib} ---
+         A parser for HTML documents.}
 \declaremodule{standard}{htmllib}
 
 \modulesynopsis{A parser for HTML documents.}

Doc/lib/libhttplib.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{httplib}}
+\section{\module{httplib} ---
+         HTTP protocol client.}
 \declaremodule{standard}{httplib}
 
 \modulesynopsis{HTTP protocol client (requires sockets).}

Doc/lib/libimageop.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{imageop}}
+\section{\module{imageop} ---
+         Manipulate raw image data.}
 \declaremodule{builtin}{imageop}
 
 \modulesynopsis{Manipulate raw image data.}

Doc/lib/libimaplib.tex

@@ -1,10 +1,11 @@
 % Based on HTML documentation by Piers Lauder <piers@staff.cs.usyd.edu.au>;
 % converted by Fred L. Drake, Jr. <fdrake@acm.org>.
-%
-% The imaplib module was written by Piers Lauder.
 
-\section{Standard Module \module{imaplib}}
+\section{\module{imaplib} ---
+         IMAP4 protocol client.}
 \declaremodule{standard}{imaplib}
+\moduleauthor{Piers Lauder}{piers@staff.cs.usyd.edu.au}
+\sectionauthor{Piers Lauder}{piers@staff.cs.usyd.edu.au}
 
 \modulesynopsis{IMAP4 protocol client (requires sockets).}
 

Doc/lib/libimgfile.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{imgfile}}
+\section{\module{imgfile} ---
+         Support for SGI imglib files.}
 \declaremodule{builtin}{imgfile}
 
 \modulesynopsis{Support for SGI imglib files.}

Doc/lib/libimghdr.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{imghdr}}
+\section{\module{imghdr} ---
+         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.}

Doc/lib/libimp.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{imp}}
+\section{\module{imp} ---
+         Access the implementation of the \keyword{import} statement.}
 \declaremodule{builtin}{imp}
 
 \modulesynopsis{Access the implementation of the \keyword{import} statement.}

Doc/lib/libjpeg.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{jpeg}}
+\section{\module{jpeg} ---
+         Read and write image files in compressed JPEG format.}
 \declaremodule{builtin}{jpeg}
 
 \modulesynopsis{Read and write image files in compressed JPEG format.}

Doc/lib/libkeyword.tex

@@ -1,7 +1,8 @@
-\section{Standard Module \module{keyword}}
+\section{\module{keyword} ---
+         Test whether a string is a Python keyword.}
 \declaremodule{standard}{keyword}
 
-\modulesynopsis{Test whether a string is a keyword in the Python language.}
+\modulesynopsis{Test whether a string is a keyword in Python.}
 
 
 This module allows a Python program to determine if a string is a

Doc/lib/liblocale.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{locale}}
+\section{\module{locale} ---
+         Internationalization services.}
 \declaremodule{standard}{locale}
 
 

Doc/lib/libmailbox.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{mailbox}}
+\section{\module{mailbox} ---
+         Read various mailbox formats.}
 \declaremodule{standard}{mailbox}
 
 \modulesynopsis{Read various mailbox formats.}

Doc/lib/libmailcap.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{mailcap}}
+\section{\module{mailcap} ---
+         Mailcap file handling.}
 \declaremodule{standard}{mailcap}
 
 \modulesynopsis{Mailcap file handling.}

Doc/lib/libmain.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{__main__}}
+\section{\module{__main__} ---
+         Top-level script environment.}
 \declaremodule[main]{builtin}{__main__}
 
 \modulesynopsis{The environment where the top-level script is run.}

Doc/lib/libmarshal.tex

@@ -1,8 +1,9 @@
-\section{Built-in Module \module{marshal}}
+\section{\module{marshal} ---
+         Python object serialization (with different constraints).}
 \declaremodule{builtin}{marshal}
 
-\modulesynopsis{Convert Python objects to streams of bytes and back (with
-different constraints).}
+\modulesynopsis{Convert Python objects to streams of bytes and back
+(with different constraints).}
 
 
 This module contains functions that can read and write Python

Doc/lib/libmath.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{math}}
+\section{\module{math} ---
+         Mathematical functions (\function{sin()} etc.).}
 \declaremodule{builtin}{math}
 
 

Doc/lib/libmd5.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{md5}}
+\section{\module{md5} ---
+         MD5 message digest algorithm.}
 \declaremodule{builtin}{md5}
 
 \modulesynopsis{RSA's MD5 message digest algorithm.}

Doc/lib/libmimetools.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{mimetools}}
+\section{\module{mimetools} ---
+         Tools for parsing MIME style message bodies.}
 \declaremodule{standard}{mimetools}
 
 \modulesynopsis{Tools for parsing MIME style message bodies.}

Doc/lib/libmimetypes.tex

@@ -2,7 +2,8 @@
 % <fdrake@acm.org>, based in part on original docstrings in the
 % mimetypes module.
 
-\section{Standard Module \module{mimetypes}}
+\section{\module{mimetypes} ---
+         Mapping of filename extensions to MIME types.}
 \declaremodule{standard}{mimetypes}
 
 \modulesynopsis{Mapping of filename extensions to MIME types.}

Doc/lib/libmimify.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{mimify}}
+\section{\module{mimify} ---
+         Mimification and unmimification of mail messages.}
 \declaremodule{standard}{mimify}
 
 \modulesynopsis{Mimification and unmimification of mail messages.}

Doc/lib/libmpz.tex

@@ -1,7 +1,9 @@
-\section{Built-in Module \module{mpz}}
+\section{\module{mpz} ---
+         GNU MP library for arbitrary precision arithmetic.}
 \declaremodule{builtin}{mpz}
 
-\modulesynopsis{Interface to the GNU MP library for arbitrary precision arithmetic.}
+\modulesynopsis{Interface to the GNU MP library for arbitrary
+precision arithmetic.}
 
 
 This is an optional module.  It is only available when Python is

Doc/lib/libmultifile.tex

@@ -1,6 +1,7 @@
-% Documentation by ESR
-\section{Standard Module \module{multifile}}
+\section{\module{multifile} ---
+         Support for reading files which contain distinct parts.}
 \declaremodule{standard}{multifile}
+\sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com}
 
 \modulesynopsis{Support for reading files which contain distinct
 parts, such as some MIME data.}

Doc/lib/libni.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{ni}}
+\section{\module{ni} ---
+         None}
 \declaremodule{standard}{ni}
 
 \modulesynopsis{None}

Doc/lib/libnntplib.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{nntplib}}
+\section{\module{nntplib} ---
+         NNTP protocol client.}
 \declaremodule{standard}{nntplib}
 
 \modulesynopsis{NNTP protocol client (requires sockets).}

Doc/lib/liboperator.tex

@@ -1,7 +1,7 @@
-% Contributed by Skip Montanaro, from the module's doc strings.
-
-\section{Built-in Module \module{operator}}
+\section{\module{operator} ---
+         Standard operators as functions.}
 \declaremodule{builtin}{operator}
+\sectionauthor{Skip Montanaro}{skip@automatrix.com}
 
 \modulesynopsis{All Python's standard operators as built-in functions.}
 
@@ -90,7 +90,7 @@ Return the outcome of \keyword{not} \var{o}.
 \end{funcdesc}
 
 \begin{funcdesc}{truth}{o}
-Return 1 if \var{o} is true, and 0 otherwise.
+Return \code{1} if \var{o} is true, and 0 otherwise.
 \end{funcdesc}
 
 \begin{funcdesc}{concat}{a, b}

Doc/lib/libos.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{os}}
+\section{\module{os} ---
+         Miscellaneous OS interfaces.}
 \declaremodule{standard}{os}
 
 \modulesynopsis{Miscellaneous OS interfaces.}

Doc/lib/libpanel.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{panel}}
+\section{\module{panel} ---
+         None}
 \declaremodule{standard}{panel}
 
 \modulesynopsis{None}
@@ -31,7 +32,8 @@ before calling
 or
 \code{panel.defpanellist()}.
 
-\section{Standard Module \module{panelparser}}
+\section{\module{panelparser} ---
+         None}
 \declaremodule{standard}{panelparser}
 
 \modulesynopsis{None}
@@ -49,7 +51,8 @@ to Python strings and sub-expressions (recursively) to Python lists.
 For more details, read the module file.
 % XXXXJH should be funcdesc, I think
 
-\section{Built-in Module \module{pnl}}
+\section{\module{pnl} ---
+         None}
 \declaremodule{builtin}{pnl}
 
 \modulesynopsis{None}

Doc/lib/libparser.tex

@@ -9,11 +9,13 @@
 % in any way.
 %
 
-\section{Built-in Module \module{parser}}
+\section{\module{parser} ---
+         Access parse trees of Python code.}
 \declaremodule{builtin}{parser}
+\moduleauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
+\sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
 
-\modulesynopsis{Retrieve and submit parse trees from and to the runtime support
-environment.}
+\modulesynopsis{Access parse trees of Python source code.}
 
 \index{parsing!Python source code}
 

Doc/lib/libpickle.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{pickle}}
+\section{\module{pickle} ---
+         Python object serialization.}
 \declaremodule{standard}{pickle}
 
 \modulesynopsis{Convert Python objects to streams of bytes and back.}
@@ -274,7 +275,8 @@ registration}
 \end{seealso}
 
 
-\section{Built-in Module \module{cPickle}}
+\section{\module{cPickle} ---
+         Alternate implementation of \module{pickle}.}
 \declaremodule{builtin}{cPickle}
 
 \modulesynopsis{Faster version of \module{pickle}, but not subclassable.}

Doc/lib/libpopen2.tex

@@ -2,9 +2,12 @@
 % <drew_csillag@geocities.com>, with some re-organization by Fred L.
 % Drake, Jr. <fdrake@acm.org>.
 
-\section{Standard Module \module{popen2}}
+\section{\module{popen2} ---
+         Subprocesses with accessible standard I/O streams.}
 \declaremodule{standard}{popen2}
 
+\sectionauthor{Drew Csillag}{drew_csillag@geocities.com}
+
 \modulesynopsis{Subprocesses with accessible standard I/O streams.}
 
 

Doc/lib/libpoplib.tex

@@ -3,7 +3,8 @@
 %it since I just stole most of it from the poplib.py source code and
 %the imaplib ``chapter''.
 
-\section{Standard Module \module{poplib}}
+\section{\module{poplib} ---
+         POP3 protocol client.}
 \declaremodule{standard}{poplib}
 
 \modulesynopsis{POP3 protocol client (requires sockets).}

Doc/lib/libposix.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{posix}}
+\section{\module{posix} ---
+         The most common \POSIX{} system calls.}
 \declaremodule{builtin}{posix}
 
 \modulesynopsis{The most common \POSIX{} system calls (normally used via module

Doc/lib/libposixfile.tex

@@ -1,5 +1,6 @@
 % Manual text and implementation by Jaap Vermeulen
-\section{Standard Module \module{posixfile}}
+\section{\module{posixfile} ---
+         A file-like object with support for locking.}
 \declaremodule{builtin}{posixfile}
 
 \modulesynopsis{A file-like object with support for locking.}

Doc/lib/libposixpath.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{posixpath}}
+\section{\module{posixpath} ---
+         Common \POSIX{} pathname manipulations.}
 \declaremodule{standard}{posixpath}
 
 \modulesynopsis{Common \POSIX{} pathname manipulations.}

Doc/lib/libpprint.tex

@@ -1,6 +1,7 @@
 %%  Author:  Fred L. Drake, Jr.		<fdrake@acm.org>
 
-\section{Standard Module \module{pprint}}
+\section{\module{pprint} ---
+         Data pretty printer.}
 \declaremodule{standard}{pprint}
 
 \modulesynopsis{Data pretty printer.}

Doc/lib/libpwd.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{pwd}}
+\section{\module{pwd} ---
+         The password database.}
 \declaremodule{builtin}{pwd}
 
 

Doc/lib/libqueue.tex

@@ -1,7 +1,8 @@
-\section{Standard Module \module{Queue}}
+\section{\module{Queue} ---
+         A synchronized queue class.}
 \declaremodule{standard}{Queue}
 
-\modulesynopsis{A stynchronized queue class.}
+\modulesynopsis{A synchronized queue class.}
 
 
 

Doc/lib/libquopri.tex

@@ -1,7 +1,9 @@
-\section{Standard Module \module{quopri}}
+\section{\module{quopri} ---
+         Encode and decode MIME quoted-printable encoding.}
 \declaremodule{standard}{quopri}
 
-\modulesynopsis{Encode/decode binary files using the MIME quoted-printable encoding.}
+\modulesynopsis{Encode and decode files using the MIME
+quoted-printable encoding.}
 
 
 This module performs quoted-printable transport encoding and decoding,

Doc/lib/librand.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{rand}}
+\section{\module{rand} ---
+         None}
 \declaremodule{standard}{rand}
 
 \modulesynopsis{None}

Doc/lib/librandom.tex

@@ -1,7 +1,9 @@
-\section{Standard Module \module{random}}
+\section{\module{random} ---
+         Generate pseudo-random numbers with various distributions.}
 \declaremodule{standard}{random}
 
-\modulesynopsis{Generate pseudo-random numbers with various common distributions.}
+\modulesynopsis{Generate pseudo-random numbers with various common
+distributions.}
 
 
 This module implements pseudo-random number generators for various

Doc/lib/libre.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{re}}
+\section{\module{re} ---
+         New Perl-style regular expression search and match operations.}
 \declaremodule{standard}{re}
 \moduleauthor{Andrew M. Kuchling}{akuchling@acm.org}
 \sectionauthor{Andrew M. Kuchling}{akuchling@acm.org}

Doc/lib/libregex.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{regex}}
+\section{\module{regex} ---
+         Regular expression search and match operations.}
 \declaremodule{builtin}{regex}
 
 \modulesynopsis{Regular expression search and match operations.}

Doc/lib/libregsub.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{regsub}}
+\section{\module{regsub} ---
+         Substitution and splitting operations that use regular expressions.}
 \declaremodule{standard}{regsub}
 
 \modulesynopsis{Substitution and splitting operations that use regular expressions.}

Doc/lib/libresource.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{resource}}
+\section{\module{resource} ---
+         Resource usage information.}
 \declaremodule{builtin}{resource}
 
 

Doc/lib/librexec.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{rexec}}
+\section{\module{rexec} ---
+         Basic restricted execution framework.}
 \declaremodule{standard}{rexec}
 
 \modulesynopsis{Basic restricted execution framework.}

Doc/lib/librfc822.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{rfc822}}
+\section{\module{rfc822} ---
+         Parse RFC 822 mail headers.}
 \declaremodule{standard}{rfc822}
 
 \modulesynopsis{Parse \rfc{822} style mail headers.}

Doc/lib/librgbimg.tex

@@ -1,8 +1,9 @@
-\section{Built-in Module \module{rgbimg}}
+\section{\module{rgbimg} ---
+         Read and write image files in ``SGI RGB'' format.}
 \declaremodule{builtin}{rgbimg}
 
 \modulesynopsis{Read and write image files in ``SGI RGB'' format (the module is
-\emph{not} SGI specific though)!}
+\emph{not} SGI specific though!).}
 
 
 The \module{rgbimg} module allows Python programs to access SGI imglib image

Doc/lib/librotor.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{rotor}}
+\section{\module{rotor} ---
+         Enigma-like encryption and decryption.}
 \declaremodule{builtin}{rotor}
 
 \modulesynopsis{Enigma-like encryption and decryption.}

Doc/lib/libselect.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{select}}
+\section{\module{select} ---
+         Wait for I/O completion on multiple streams.}
 \declaremodule{builtin}{select}
 
 \modulesynopsis{Wait for I/O completion on multiple streams.}

Doc/lib/libsgmllib.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{sgmllib}}
+\section{\module{sgmllib} ---
+         Simple SGML parser.}
 \declaremodule{standard}{sgmllib}
 
 \modulesynopsis{Only as much of an SGML parser as needed to parse HTML.}

Doc/lib/libshelve.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{shelve}}
+\section{\module{shelve} ---
+         Python object persistency.}
 \declaremodule{standard}{shelve}
 
 \modulesynopsis{Python object persistency.}

Doc/lib/libsignal.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{signal}}
+\section{\module{signal} ---
+         Set handlers for asynchronous events.}
 \declaremodule{builtin}{signal}
 
 

Doc/lib/libsite.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{site}}
+\section{\module{site} ---
+         A standard way to reference site-specific modules.}
 \declaremodule{standard}{site}
 
 \modulesynopsis{A standard way to reference site-specific modules.}

Doc/lib/libsmtplib.tex

@@ -1,6 +1,7 @@
-% Documentation by ESR
-\section{Standard Module \module{smtplib}}
+\section{\module{smtplib} ---
+         SMTP protocol client.}
 \declaremodule{standard}{smtplib}
+\sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com}
 
 \modulesynopsis{SMTP protocol client (requires sockets).}
 

Doc/lib/libsocket.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{socket}}
+\section{\module{socket} ---
+         Low-level networking interface.}
 \declaremodule{builtin}{socket}
 
 \modulesynopsis{Low-level networking interface.}

Doc/lib/libsocksvr.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{SocketServer}}
+\section{\module{SocketServer} ---
+         A framework for network servers.}
 \declaremodule{standard}{SocketServer}
 
 \modulesynopsis{A framework for network servers.}

Doc/lib/libsoundex.tex

@@ -1,4 +1,5 @@
-\section{Built-in Module \module{soundex}}
+\section{\module{soundex} ---
+         None}
 \declaremodule{builtin}{soundex}
 
 \modulesynopsis{None}

Doc/lib/libstat.tex

@@ -1,18 +1,20 @@
-% By Skip Montanaro
-
-\section{Standard Module \module{stat}}
+\section{\module{stat} ---
+         Utilities for interpreting \function{stat()} results.}
 \declaremodule{standard}{stat}
+\sectionauthor{Skip Montanaro}{skip@automatrix.com}
+
 
 \modulesynopsis{Utilities for interpreting the results of
 \function{os.stat()}, \function{os.lstat()} and \function{os.fstat()}.}
 
 
-The \code{stat} module defines constants and functions for interpreting the
-results of \code{os.stat()} and \code{os.lstat()} (if they exist).
-For complete details about the \code{stat()} and \code{lstat()} system
-calls, consult your local man pages.
+The \module{stat} module defines constants and functions for
+interpreting the results of \function{os.stat()} and
+\function{os.lstat()} (if they exist).  For complete details about the
+\cfunction{stat()} and \cfunction{lstat()} system calls, consult your
+local man pages.
 
-The \code{stat} module defines the following functions:
+The \module{stat} module defines the following functions:
 
 
 \begin{funcdesc}{S_ISDIR}{mode}

Doc/lib/libstdwin.tex

@@ -14,7 +14,8 @@ of dialogs.  For most platforms, alternative, native solutions exist
 under X11, Win32 for Windows and Windows NT, and a collection of
 native toolkit interfaces for the Macintosh.
 
-\section{Built-in Module \module{stdwin}}
+\section{\module{stdwin} ---
+         None}
 \declaremodule{builtin}{stdwin}
 
 \modulesynopsis{None}
@@ -777,7 +778,8 @@ def main():
 main()
 \end{verbatim}
 %
-\section{Standard Module \module{stdwinevents}}
+\section{\module{stdwinevents} ---
+         None}
 \declaremodule{standard}{stdwinevents}
 
 \modulesynopsis{None}
@@ -794,7 +796,8 @@ Suggested usage is
 >>> 
 \end{verbatim}
 %
-\section{Standard Module \module{rect}}
+\section{\module{rect} ---
+         None}
 \declaremodule{standard}{rect}
 
 \modulesynopsis{None}

Doc/lib/libstring.tex

@@ -1,4 +1,5 @@
-\section{Standard Module \module{string}}
+\section{\module{string} ---
+         Common string operations.}
 \declaremodule{standard}{string}
 
 \modulesynopsis{Common string operations.}