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 @@ \subsection{Port Objects}
 \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 @@ \section{Standard Module \module{anydbm}}
 
 
 
-\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
 % <[email protected]>.
 
-\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 <[email protected]>.
 
-\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}{[email protected]}
 
-\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}{[email protected]}
 
 \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}{[email protected]}
+\sectionauthor{Fred L. Drake, Jr.}{[email protected]}
 
-\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 @@ \subsection{FORMS Objects}
   \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 @@ \section{Standard Module \module{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 @@ \section{Built-in Module \module{gl}}
 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 @@ \section{Standard Module \module{DEVICE}}
 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.}