New section header style.
Fix up a few synopses.
diff --git a/Doc/lib/libaifc.tex b/Doc/lib/libaifc.tex
index d7433e7..76ff871 100644
--- a/Doc/lib/libaifc.tex
+++ b/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.}
diff --git a/Doc/lib/libal.tex b/Doc/lib/libal.tex
index 8b9a8f8..e1b1e6f 100644
--- a/Doc/lib/libal.tex
+++ b/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 @@
\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.}
diff --git a/Doc/lib/libamoeba.tex b/Doc/lib/libamoeba.tex
index e59b487..3bc7b89 100644
--- a/Doc/lib/libamoeba.tex
+++ b/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}
diff --git a/Doc/lib/libanydbm.tex b/Doc/lib/libanydbm.tex
index 2344c5a..11f5783 100644
--- a/Doc/lib/libanydbm.tex
+++ b/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{dumbdbm}}
+\section{\module{dumbdbm} ---
+ Portable implementation of the simple DBM interface.}
\declaremodule{standard}{dumbdbm}
\modulesynopsis{Portable implementation of the simple DBM interface.}
diff --git a/Doc/lib/libarray.tex b/Doc/lib/libarray.tex
index 4c8b5f2..b36ee26 100644
--- a/Doc/lib/libarray.tex
+++ b/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.}
diff --git a/Doc/lib/libaudioop.tex b/Doc/lib/libaudioop.tex
index 5081a60..2a3e9b0 100644
--- a/Doc/lib/libaudioop.tex
+++ b/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.}
diff --git a/Doc/lib/libbase64.tex b/Doc/lib/libbase64.tex
index 2d34e1d..aa68c04 100644
--- a/Doc/lib/libbase64.tex
+++ b/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}
diff --git a/Doc/lib/libbasehttp.tex b/Doc/lib/libbasehttp.tex
index e680305..0a8a0fc 100644
--- a/Doc/lib/libbasehttp.tex
+++ b/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
diff --git a/Doc/lib/libbastion.tex b/Doc/lib/libbastion.tex
index 08b435d..15bb029 100644
--- a/Doc/lib/libbastion.tex
+++ b/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.}
diff --git a/Doc/lib/libbinascii.tex b/Doc/lib/libbinascii.tex
index aedb696..239565a 100644
--- a/Doc/lib/libbinascii.tex
+++ b/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
diff --git a/Doc/lib/libbinhex.tex b/Doc/lib/libbinhex.tex
index 782a272..1829b40 100644
--- a/Doc/lib/libbinhex.tex
+++ b/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.}
diff --git a/Doc/lib/libbisect.tex b/Doc/lib/libbisect.tex
index dd40bc4..246d6c7 100644
--- a/Doc/lib/libbisect.tex
+++ b/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.}
diff --git a/Doc/lib/libbltin.tex b/Doc/lib/libbltin.tex
index 3c5dad4..7e10985 100644
--- a/Doc/lib/libbltin.tex
+++ b/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.}
diff --git a/Doc/lib/libcalendar.tex b/Doc/lib/libcalendar.tex
index 553f8fa..0c7207b 100644
--- a/Doc/lib/libcalendar.tex
+++ b/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}
diff --git a/Doc/lib/libcd.tex b/Doc/lib/libcd.tex
index 7c114d8..656d156 100644
--- a/Doc/lib/libcd.tex
+++ b/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.}
diff --git a/Doc/lib/libcgi.tex b/Doc/lib/libcgi.tex
index de8d86d..b24d490 100644
--- a/Doc/lib/libcgi.tex
+++ b/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}
diff --git a/Doc/lib/libcmath.tex b/Doc/lib/libcmath.tex
index 5337967..d5328e3 100644
--- a/Doc/lib/libcmath.tex
+++ b/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}
diff --git a/Doc/lib/libcmd.tex b/Doc/lib/libcmd.tex
index d5d6cf8..153d7a3 100644
--- a/Doc/lib/libcmd.tex
+++ b/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
diff --git a/Doc/lib/libcode.tex b/Doc/lib/libcode.tex
index 12728c7..ab80fc1 100644
--- a/Doc/lib/libcode.tex
+++ b/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.}
diff --git a/Doc/lib/libcommands.tex b/Doc/lib/libcommands.tex
index bea1401..6b49fae 100644
--- a/Doc/lib/libcommands.tex
+++ b/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()}.}
diff --git a/Doc/lib/libcopy.tex b/Doc/lib/libcopy.tex
index c019476..14e667e 100644
--- a/Doc/lib/libcopy.tex
+++ b/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.}
diff --git a/Doc/lib/libcopyreg.tex b/Doc/lib/libcopyreg.tex
index 0874b4e..e6e6e44 100644
--- a/Doc/lib/libcopyreg.tex
+++ b/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.}
diff --git a/Doc/lib/libcrypt.tex b/Doc/lib/libcrypt.tex
index 418b9d5..1702324 100644
--- a/Doc/lib/libcrypt.tex
+++ b/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.}
diff --git a/Doc/lib/libdbm.tex b/Doc/lib/libdbm.tex
index b7ee647..2efa6e0 100644
--- a/Doc/lib/libdbm.tex
+++ b/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.}
diff --git a/Doc/lib/libdis.tex b/Doc/lib/libdis.tex
index 9c7fee6..116225c 100644
--- a/Doc/lib/libdis.tex
+++ b/Doc/lib/libdis.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{dis}}
+\section{\module{dis} ---
+ Disassembler.}
\declaremodule{standard}{dis}
\modulesynopsis{Disassembler.}
diff --git a/Doc/lib/liberrno.tex b/Doc/lib/liberrno.tex
index c21f0fd..7e0c1a9 100644
--- a/Doc/lib/liberrno.tex
+++ b/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.}
diff --git a/Doc/lib/libfcntl.tex b/Doc/lib/libfcntl.tex
index e693067..c64cc83 100644
--- a/Doc/lib/libfcntl.tex
+++ b/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.}
diff --git a/Doc/lib/libfileinput.tex b/Doc/lib/libfileinput.tex
index 1613cfa..5f9fc10 100644
--- a/Doc/lib/libfileinput.tex
+++ b/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
diff --git a/Doc/lib/libfl.tex b/Doc/lib/libfl.tex
index 601b2c8..3ff90a4 100644
--- a/Doc/lib/libfl.tex
+++ b/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 @@
\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 @@
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.}
diff --git a/Doc/lib/libfm.tex b/Doc/lib/libfm.tex
index b52fd26..381d93e 100644
--- a/Doc/lib/libfm.tex
+++ b/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.}
diff --git a/Doc/lib/libfnmatch.tex b/Doc/lib/libfnmatch.tex
index b1f3a1b..78d0318 100644
--- a/Doc/lib/libfnmatch.tex
+++ b/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.}
diff --git a/Doc/lib/libformatter.tex b/Doc/lib/libformatter.tex
index c1cf14f..9bb12b2 100644
--- a/Doc/lib/libformatter.tex
+++ b/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.}
diff --git a/Doc/lib/libftplib.tex b/Doc/lib/libftplib.tex
index 166fd6e..5840e83 100644
--- a/Doc/lib/libftplib.tex
+++ b/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).}
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index bc121c1..7f00121 100644
--- a/Doc/lib/libfuncs.tex
+++ b/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.
diff --git a/Doc/lib/libgdbm.tex b/Doc/lib/libgdbm.tex
index 844c3b3..adb1304 100644
--- a/Doc/lib/libgdbm.tex
+++ b/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.}
diff --git a/Doc/lib/libgetopt.tex b/Doc/lib/libgetopt.tex
index 6f839a7..72824a7 100644
--- a/Doc/lib/libgetopt.tex
+++ b/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.}
diff --git a/Doc/lib/libgl.tex b/Doc/lib/libgl.tex
index 6824418..6940437 100644
--- a/Doc/lib/libgl.tex
+++ b/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 @@
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 @@
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.}
diff --git a/Doc/lib/libglob.tex b/Doc/lib/libglob.tex
index 8c93e43..5ef06f3 100644
--- a/Doc/lib/libglob.tex
+++ b/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.}
diff --git a/Doc/lib/libgopherlib.tex b/Doc/lib/libgopherlib.tex
index a6e6fc3..e2cbaa2 100644
--- a/Doc/lib/libgopherlib.tex
+++ b/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).}
diff --git a/Doc/lib/libgrp.tex b/Doc/lib/libgrp.tex
index 986c831..b15128d 100644
--- a/Doc/lib/libgrp.tex
+++ b/Doc/lib/libgrp.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{grp}}
+\section{\module{grp} ---
+ The group database.}
\declaremodule{builtin}{grp}
diff --git a/Doc/lib/libgzip.tex b/Doc/lib/libgzip.tex
index 4bc7d80..3bae734 100644
--- a/Doc/lib/libgzip.tex
+++ b/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
diff --git a/Doc/lib/libhtmllib.tex b/Doc/lib/libhtmllib.tex
index 899e76e..100be55 100644
--- a/Doc/lib/libhtmllib.tex
+++ b/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.}
diff --git a/Doc/lib/libhttplib.tex b/Doc/lib/libhttplib.tex
index e217967..51b74eb 100644
--- a/Doc/lib/libhttplib.tex
+++ b/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).}
diff --git a/Doc/lib/libimageop.tex b/Doc/lib/libimageop.tex
index 1c01241..ded5b51 100644
--- a/Doc/lib/libimageop.tex
+++ b/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.}
diff --git a/Doc/lib/libimaplib.tex b/Doc/lib/libimaplib.tex
index 5501cd2..14daf41 100644
--- a/Doc/lib/libimaplib.tex
+++ b/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).}
diff --git a/Doc/lib/libimgfile.tex b/Doc/lib/libimgfile.tex
index d4c3002..7ea57a4 100644
--- a/Doc/lib/libimgfile.tex
+++ b/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.}
diff --git a/Doc/lib/libimghdr.tex b/Doc/lib/libimghdr.tex
index 637dca2..2a162a2 100644
--- a/Doc/lib/libimghdr.tex
+++ b/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.}
diff --git a/Doc/lib/libimp.tex b/Doc/lib/libimp.tex
index 945ffde..bf50143 100644
--- a/Doc/lib/libimp.tex
+++ b/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.}
diff --git a/Doc/lib/libjpeg.tex b/Doc/lib/libjpeg.tex
index 2c227ff..9c2c57a 100644
--- a/Doc/lib/libjpeg.tex
+++ b/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.}
diff --git a/Doc/lib/libkeyword.tex b/Doc/lib/libkeyword.tex
index 24635a5..16cff84 100644
--- a/Doc/lib/libkeyword.tex
+++ b/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
diff --git a/Doc/lib/liblocale.tex b/Doc/lib/liblocale.tex
index 9b08872..d70ffcf 100644
--- a/Doc/lib/liblocale.tex
+++ b/Doc/lib/liblocale.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{locale}}
+\section{\module{locale} ---
+ Internationalization services.}
\declaremodule{standard}{locale}
diff --git a/Doc/lib/libmailbox.tex b/Doc/lib/libmailbox.tex
index 5ebc57d..8110291 100644
--- a/Doc/lib/libmailbox.tex
+++ b/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.}
diff --git a/Doc/lib/libmailcap.tex b/Doc/lib/libmailcap.tex
index 8c8b705..e6c5396 100644
--- a/Doc/lib/libmailcap.tex
+++ b/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.}
diff --git a/Doc/lib/libmain.tex b/Doc/lib/libmain.tex
index 39edfd7..949d2b2 100644
--- a/Doc/lib/libmain.tex
+++ b/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.}
diff --git a/Doc/lib/libmarshal.tex b/Doc/lib/libmarshal.tex
index ab7cd05..a30dd1e 100644
--- a/Doc/lib/libmarshal.tex
+++ b/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
diff --git a/Doc/lib/libmath.tex b/Doc/lib/libmath.tex
index 7ecda2e..49bc226 100644
--- a/Doc/lib/libmath.tex
+++ b/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}
diff --git a/Doc/lib/libmd5.tex b/Doc/lib/libmd5.tex
index b754a66..85b380b 100644
--- a/Doc/lib/libmd5.tex
+++ b/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.}
diff --git a/Doc/lib/libmimetools.tex b/Doc/lib/libmimetools.tex
index 4cb1300..1b90d89 100644
--- a/Doc/lib/libmimetools.tex
+++ b/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.}
diff --git a/Doc/lib/libmimetypes.tex b/Doc/lib/libmimetypes.tex
index afd5cca..0beb5f5 100644
--- a/Doc/lib/libmimetypes.tex
+++ b/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.}
diff --git a/Doc/lib/libmimify.tex b/Doc/lib/libmimify.tex
index 87740b3..7d91d99 100644
--- a/Doc/lib/libmimify.tex
+++ b/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.}
diff --git a/Doc/lib/libmpz.tex b/Doc/lib/libmpz.tex
index 98f09a8..c761ea1 100644
--- a/Doc/lib/libmpz.tex
+++ b/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
diff --git a/Doc/lib/libmultifile.tex b/Doc/lib/libmultifile.tex
index 9cca993..d3fb862 100644
--- a/Doc/lib/libmultifile.tex
+++ b/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.}
diff --git a/Doc/lib/libni.tex b/Doc/lib/libni.tex
index e962eea..fa2b3ee 100644
--- a/Doc/lib/libni.tex
+++ b/Doc/lib/libni.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{ni}}
+\section{\module{ni} ---
+ None}
\declaremodule{standard}{ni}
\modulesynopsis{None}
diff --git a/Doc/lib/libnntplib.tex b/Doc/lib/libnntplib.tex
index d6e0f81..8b59fed 100644
--- a/Doc/lib/libnntplib.tex
+++ b/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).}
diff --git a/Doc/lib/liboperator.tex b/Doc/lib/liboperator.tex
index f5186e0..c329009 100644
--- a/Doc/lib/liboperator.tex
+++ b/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 @@
\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}
diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 41198ec..75d4182 100644
--- a/Doc/lib/libos.tex
+++ 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.}
diff --git a/Doc/lib/libpanel.tex b/Doc/lib/libpanel.tex
index 66ac2a8..cc56dad 100644
--- a/Doc/lib/libpanel.tex
+++ b/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 @@
or
\code{panel.defpanellist()}.
-\section{Standard Module \module{panelparser}}
+\section{\module{panelparser} ---
+ None}
\declaremodule{standard}{panelparser}
\modulesynopsis{None}
@@ -49,7 +51,8 @@
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}
diff --git a/Doc/lib/libparser.tex b/Doc/lib/libparser.tex
index cbea16d..80ad493 100644
--- a/Doc/lib/libparser.tex
+++ b/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}
diff --git a/Doc/lib/libpickle.tex b/Doc/lib/libpickle.tex
index 60999eb..6f9ece7 100644
--- a/Doc/lib/libpickle.tex
+++ b/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 @@
\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.}
diff --git a/Doc/lib/libpopen2.tex b/Doc/lib/libpopen2.tex
index d36be01..30d6e04 100644
--- a/Doc/lib/libpopen2.tex
+++ b/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.}
diff --git a/Doc/lib/libpoplib.tex b/Doc/lib/libpoplib.tex
index 2c21a7f..e3ec5e1 100644
--- a/Doc/lib/libpoplib.tex
+++ b/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).}
diff --git a/Doc/lib/libposix.tex b/Doc/lib/libposix.tex
index dbfc692..e3f2929 100644
--- a/Doc/lib/libposix.tex
+++ b/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
diff --git a/Doc/lib/libposixfile.tex b/Doc/lib/libposixfile.tex
index b1742f1..9c0ffd8 100644
--- a/Doc/lib/libposixfile.tex
+++ b/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.}
diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index 87c8010..83f468d 100644
--- a/Doc/lib/libposixpath.tex
+++ b/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.}
diff --git a/Doc/lib/libpprint.tex b/Doc/lib/libpprint.tex
index 0632875..d676dc4 100644
--- a/Doc/lib/libpprint.tex
+++ b/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.}
diff --git a/Doc/lib/libpwd.tex b/Doc/lib/libpwd.tex
index 32113b4..7841c1e 100644
--- a/Doc/lib/libpwd.tex
+++ b/Doc/lib/libpwd.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{pwd}}
+\section{\module{pwd} ---
+ The password database.}
\declaremodule{builtin}{pwd}
diff --git a/Doc/lib/libqueue.tex b/Doc/lib/libqueue.tex
index 3231e11..667d813 100644
--- a/Doc/lib/libqueue.tex
+++ b/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.}
diff --git a/Doc/lib/libquopri.tex b/Doc/lib/libquopri.tex
index 6b1d209..748579d 100644
--- a/Doc/lib/libquopri.tex
+++ b/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,
diff --git a/Doc/lib/librand.tex b/Doc/lib/librand.tex
index 7a5adea..e335718 100644
--- a/Doc/lib/librand.tex
+++ b/Doc/lib/librand.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{rand}}
+\section{\module{rand} ---
+ None}
\declaremodule{standard}{rand}
\modulesynopsis{None}
diff --git a/Doc/lib/librandom.tex b/Doc/lib/librandom.tex
index 4806876..63abbb3 100644
--- a/Doc/lib/librandom.tex
+++ b/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
diff --git a/Doc/lib/libre.tex b/Doc/lib/libre.tex
index 79d93ad..a453fbf 100644
--- a/Doc/lib/libre.tex
+++ b/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}
diff --git a/Doc/lib/libregex.tex b/Doc/lib/libregex.tex
index 253d50b..ffe959a 100644
--- a/Doc/lib/libregex.tex
+++ b/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.}
diff --git a/Doc/lib/libregsub.tex b/Doc/lib/libregsub.tex
index 0a75f36..b779193 100644
--- a/Doc/lib/libregsub.tex
+++ b/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.}
diff --git a/Doc/lib/libresource.tex b/Doc/lib/libresource.tex
index 887268e..1d70e9e 100644
--- a/Doc/lib/libresource.tex
+++ b/Doc/lib/libresource.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{resource}}
+\section{\module{resource} ---
+ Resource usage information.}
\declaremodule{builtin}{resource}
diff --git a/Doc/lib/librexec.tex b/Doc/lib/librexec.tex
index 8881c93..a7e8913 100644
--- a/Doc/lib/librexec.tex
+++ b/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.}
diff --git a/Doc/lib/librfc822.tex b/Doc/lib/librfc822.tex
index e9317d2..61aadd8 100644
--- a/Doc/lib/librfc822.tex
+++ b/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.}
diff --git a/Doc/lib/librgbimg.tex b/Doc/lib/librgbimg.tex
index d06eb76..5ef0603 100644
--- a/Doc/lib/librgbimg.tex
+++ b/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
diff --git a/Doc/lib/librotor.tex b/Doc/lib/librotor.tex
index a59e2ca..5cfe2b7 100644
--- a/Doc/lib/librotor.tex
+++ b/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.}
diff --git a/Doc/lib/libselect.tex b/Doc/lib/libselect.tex
index b8dfacc..eec8de1 100644
--- a/Doc/lib/libselect.tex
+++ b/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.}
diff --git a/Doc/lib/libsgmllib.tex b/Doc/lib/libsgmllib.tex
index 642dacd..a8dfa0b 100644
--- a/Doc/lib/libsgmllib.tex
+++ b/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.}
diff --git a/Doc/lib/libshelve.tex b/Doc/lib/libshelve.tex
index 6b5aa76..4b7f773 100644
--- a/Doc/lib/libshelve.tex
+++ b/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.}
diff --git a/Doc/lib/libsignal.tex b/Doc/lib/libsignal.tex
index 86d6967..ee68ace 100644
--- a/Doc/lib/libsignal.tex
+++ b/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}
diff --git a/Doc/lib/libsite.tex b/Doc/lib/libsite.tex
index 020b266..e8bafd6 100644
--- a/Doc/lib/libsite.tex
+++ b/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.}
diff --git a/Doc/lib/libsmtplib.tex b/Doc/lib/libsmtplib.tex
index 21cadce..d7929eb 100644
--- a/Doc/lib/libsmtplib.tex
+++ b/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).}
diff --git a/Doc/lib/libsocket.tex b/Doc/lib/libsocket.tex
index 47a2914..c6476b9 100644
--- a/Doc/lib/libsocket.tex
+++ b/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.}
diff --git a/Doc/lib/libsocksvr.tex b/Doc/lib/libsocksvr.tex
index a07b0e3..80ac724 100644
--- a/Doc/lib/libsocksvr.tex
+++ b/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.}
diff --git a/Doc/lib/libsoundex.tex b/Doc/lib/libsoundex.tex
index 83e8bc7..8073a8c 100644
--- a/Doc/lib/libsoundex.tex
+++ b/Doc/lib/libsoundex.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{soundex}}
+\section{\module{soundex} ---
+ None}
\declaremodule{builtin}{soundex}
\modulesynopsis{None}
diff --git a/Doc/lib/libstat.tex b/Doc/lib/libstat.tex
index 102630a..b74e98b 100644
--- a/Doc/lib/libstat.tex
+++ b/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}
diff --git a/Doc/lib/libstdwin.tex b/Doc/lib/libstdwin.tex
index 64ccdd9..9edfba5 100644
--- a/Doc/lib/libstdwin.tex
+++ b/Doc/lib/libstdwin.tex
@@ -14,7 +14,8 @@
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 @@
main()
\end{verbatim}
%
-\section{Standard Module \module{stdwinevents}}
+\section{\module{stdwinevents} ---
+ None}
\declaremodule{standard}{stdwinevents}
\modulesynopsis{None}
@@ -794,7 +796,8 @@
>>>
\end{verbatim}
%
-\section{Standard Module \module{rect}}
+\section{\module{rect} ---
+ None}
\declaremodule{standard}{rect}
\modulesynopsis{None}
diff --git a/Doc/lib/libstring.tex b/Doc/lib/libstring.tex
index 226f453..f7189fd 100644
--- a/Doc/lib/libstring.tex
+++ b/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.}
diff --git a/Doc/lib/libstringio.tex b/Doc/lib/libstringio.tex
index 6b7d2c5..0e59e03 100644
--- a/Doc/lib/libstringio.tex
+++ b/Doc/lib/libstringio.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{StringIO}}
+\section{\module{StringIO} ---
+ Read and write strings as if they were files.}
\declaremodule{standard}{StringIO}
@@ -28,7 +29,8 @@
\end{methoddesc}
-\section{Built-in Module \module{cStringIO}}
+\section{\module{cStringIO} ---
+ Faster version of \module{StringIO}, but not subclassable.}
\declaremodule{builtin}{cStringIO}
\modulesynopsis{Faster version of \module{StringIO}, but not subclassable.}
diff --git a/Doc/lib/libstruct.tex b/Doc/lib/libstruct.tex
index 08b930c..be7d80b 100644
--- a/Doc/lib/libstruct.tex
+++ b/Doc/lib/libstruct.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{struct}}
+\section{\module{struct} ---
+ Interpret strings as packed binary data.}
\declaremodule{builtin}{struct}
\modulesynopsis{Interpret strings as packed binary data.}
diff --git a/Doc/lib/libsunaudio.tex b/Doc/lib/libsunaudio.tex
index 920b048..cc7c1ed 100644
--- a/Doc/lib/libsunaudio.tex
+++ b/Doc/lib/libsunaudio.tex
@@ -1,10 +1,11 @@
-\section{Built-in Module \module{sunaudiodev}}
+\section{\module{sunaudiodev} ---
+ Access to Sun audio hardware.}
\declaremodule{builtin}{sunaudiodev}
-\modulesynopsis{None}
+\modulesynopsis{Access to Sun audio hardware.}
-This module allows you to access the sun audio interface. The sun
+This module allows you to access the Sun audio interface. The Sun
audio hardware is capable of recording and playing back audio data
in u-LAW\index{u-LAW} format with a sample rate of 8K per second. A
full description can be found in the \manpage{audio}{7I} manual page.
diff --git a/Doc/lib/libsymbol.tex b/Doc/lib/libsymbol.tex
index 6dbc76e..7d9f9ac 100644
--- a/Doc/lib/libsymbol.tex
+++ b/Doc/lib/libsymbol.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{symbol}}
+\section{\module{symbol} ---
+ Constants representing internal nodes of the parse tree.}
\declaremodule{standard}{symbol}
\modulesynopsis{Constants representing internal nodes of the parse tree.}
diff --git a/Doc/lib/libsys.tex b/Doc/lib/libsys.tex
index 1f37bc8..eadd978 100644
--- a/Doc/lib/libsys.tex
+++ b/Doc/lib/libsys.tex
@@ -1,7 +1,8 @@
-\section{Built-in Module \module{sys}}
+\section{\module{sys} ---
+ System-specific parameters and functions.}
\declaremodule{builtin}{sys}
-\modulesynopsis{Access system specific parameters and functions.}
+\modulesynopsis{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.
diff --git a/Doc/lib/libsyslog.tex b/Doc/lib/libsyslog.tex
index cd32bbf..70a05be 100644
--- a/Doc/lib/libsyslog.tex
+++ b/Doc/lib/libsyslog.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{syslog}}
+\section{\module{syslog} ---
+ \UNIX{} syslog library routines.}
\declaremodule{builtin}{syslog}
\modulesynopsis{An interface to the \UNIX{} syslog library routines.}
diff --git a/Doc/lib/libtempfile.tex b/Doc/lib/libtempfile.tex
index dadd357..95034bb 100644
--- a/Doc/lib/libtempfile.tex
+++ b/Doc/lib/libtempfile.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{tempfile}}
+\section{\module{tempfile} ---
+ Generate temporary file names.}
\declaremodule{standard}{tempfile}
\modulesynopsis{Generate temporary file names.}
diff --git a/Doc/lib/libtemplate.tex b/Doc/lib/libtemplate.tex
index e82bb21..cff05d1 100644
--- a/Doc/lib/libtemplate.tex
+++ b/Doc/lib/libtemplate.tex
@@ -3,26 +3,32 @@
% ==== 1. ====
-% Choose one of the following section headers and index entries;
-% \section generates the section header, \declmodule produces the
-% appropriate index entry for this module. Note that these should
-% only be used for the defining entry for the module. Other
-% references to the module should use \refbimodindex, \refstmodindex,
-% \refexmodindex or \refmodindex, as appropriate.
+% The section prologue. Give the section a title and provide some
+% meta-information. References to the module should use
+% \refbimodindex, \refstmodindex, \refexmodindex or \refmodindex, as
+% appropriate.
-\section{Built-in Module \module{spam}} % If implemented in C, in
-\declaremodule{builtin}{spam} % standard library
+\section{\module{spam} ---
+ Short one-line descrition, for section title.}
-\section{Standard Module \module{spam}} % If implemented in Python, in
-\declaremodule{standard}{spam} % standard library
+% Choose one of these to specify the module module name. If there's
+% an underscore in the name, use
+% \declaremodule[modname]{...}{mod_name} instead.
+%
+\declaremodule{builtin}{spam} % standard library, in C
+\declaremodule{standard}{spam} % standard library, in Python
+\declaremodule{extension}{spam} % not standard, in C
+\declaremodule{}{spam} % not standard, in Python
-\section{Extension Module \module{spam}}% If implemented in C, but not
-\declaremodule{extension}{spam} % in standard library
+% These apply to all modules:
-\section{Module \module{spam}} % If implemented in Python, but not
-\declaremodule{}{spam} % in standard library
+\moduleauthor{name}{email} % Author of the module code;
+ % omit if not known.
+\sectionauthor{name}{email} % Author of the documentation.
+% Leave at least one blank line after this, to simplify ad-hoc tools
+% that are sometimes used to massage these files.
\modulesynopsis{This is a one-line descrition, for the chapter header.}
diff --git a/Doc/lib/libtermios.tex b/Doc/lib/libtermios.tex
index 18b63bf..9c9c3c8 100644
--- a/Doc/lib/libtermios.tex
+++ b/Doc/lib/libtermios.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{termios}}
+\section{\module{termios} ---
+ \POSIX{} style tty control.}
\declaremodule{builtin}{termios}
\modulesynopsis{\POSIX{} style tty control.}
@@ -94,10 +95,12 @@
return passwd
\end{verbatim}
-\section{Standard Module \module{TERMIOS}}
+\section{\module{TERMIOS} ---
+ Constants used with the \module{termios} module.}
\declaremodule[TERMIOSuppercase]{standard}{TERMIOS}
-\modulesynopsis{The symbolic constants required to use the \module{termios} module.}
+\modulesynopsis{Symbolic constants required to use the
+\module{termios} module.}
\indexii{\POSIX{}}{I/O control}
\indexii{tty}{I/O control}
diff --git a/Doc/lib/libthread.tex b/Doc/lib/libthread.tex
index 2e55b41..df87118 100644
--- a/Doc/lib/libthread.tex
+++ b/Doc/lib/libthread.tex
@@ -1,7 +1,8 @@
-\section{Built-in Module \module{thread}}
+\section{\module{thread} ---
+ Multiple threads of control.}
\declaremodule{builtin}{thread}
-\modulesynopsis{Create multiple threads of control within one namespace.}
+\modulesynopsis{Create multiple threads of control within one interpreter.}
This module provides low-level primitives for working with multiple
diff --git a/Doc/lib/libthreading.tex b/Doc/lib/libthreading.tex
index 928b422..d2c5ff3 100644
--- a/Doc/lib/libthreading.tex
+++ b/Doc/lib/libthreading.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{threading}}
+\section{\module{threading} ---
+ Higher-level threading interfaces.}
\declaremodule{standard}{threading}
\modulesynopsis{Higher-level threading interfaces.}
diff --git a/Doc/lib/libtime.tex b/Doc/lib/libtime.tex
index caafd50..f63ecb0 100644
--- a/Doc/lib/libtime.tex
+++ b/Doc/lib/libtime.tex
@@ -1,4 +1,5 @@
-\section{Built-in Module \module{time}}
+\section{\module{time} ---
+ Time access and conversions.}
\declaremodule{builtin}{time}
\modulesynopsis{Time access and conversions.}
diff --git a/Doc/lib/libtoken.tex b/Doc/lib/libtoken.tex
index ce3bd5c..87477c5 100644
--- a/Doc/lib/libtoken.tex
+++ b/Doc/lib/libtoken.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{token}}
+\section{\module{token} ---
+ Constants representing terminal nodes of the parse tree.}
\declaremodule{standard}{token}
\modulesynopsis{Constants representing terminal nodes of the parse tree.}
diff --git a/Doc/lib/libtraceback.tex b/Doc/lib/libtraceback.tex
index 29c8ac6..e2a7e07 100644
--- a/Doc/lib/libtraceback.tex
+++ b/Doc/lib/libtraceback.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{traceback}}
+\section{\module{traceback} ---
+ Print or retrieve a stack traceback.}
\declaremodule{standard}{traceback}
\modulesynopsis{Print or retrieve a stack traceback.}
diff --git a/Doc/lib/libtypes.tex b/Doc/lib/libtypes.tex
index f3c4ee0..5f9034c 100644
--- a/Doc/lib/libtypes.tex
+++ b/Doc/lib/libtypes.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{types}}
+\section{\module{types} ---
+ Names for all built-in types.}
\declaremodule{standard}{types}
\modulesynopsis{Names for all built-in types.}
diff --git a/Doc/lib/liburllib.tex b/Doc/lib/liburllib.tex
index 7a98582..ab57e55 100644
--- a/Doc/lib/liburllib.tex
+++ b/Doc/lib/liburllib.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{urllib}}
+\section{\module{urllib} ---
+ Open an arbitrary object given by URL.}
\declaremodule{standard}{urllib}
\modulesynopsis{Open an arbitrary object given by URL (requires sockets).}
diff --git a/Doc/lib/liburlparse.tex b/Doc/lib/liburlparse.tex
index 9a2b4f5..60c83cc 100644
--- a/Doc/lib/liburlparse.tex
+++ b/Doc/lib/liburlparse.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{urlparse}}
+\section{\module{urlparse} ---
+ Parse URLs into components.}
\declaremodule{standard}{urlparse}
\modulesynopsis{Parse URLs into components.}
diff --git a/Doc/lib/libuser.tex b/Doc/lib/libuser.tex
index 5527225..484af7e 100644
--- a/Doc/lib/libuser.tex
+++ b/Doc/lib/libuser.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{user}}
+\section{\module{user} ---
+ A standard way to reference user-specific modules.}
\declaremodule{standard}{user}
\modulesynopsis{A standard way to reference user-specific modules.}
diff --git a/Doc/lib/libuserdict.tex b/Doc/lib/libuserdict.tex
index 6c29906..f37d4cc 100644
--- a/Doc/lib/libuserdict.tex
+++ b/Doc/lib/libuserdict.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{UserDict}}
+\section{\module{UserDict} ---
+ Class wrapper for dictionary objects.}
\declaremodule{standard}{UserDict}
\modulesynopsis{Class wrapper for dictionary objects.}
@@ -24,7 +25,8 @@
\end{memberdesc}
-\section{Standard Module \module{UserList}}
+\section{\module{UserList} ---
+ Class wrapper for list objects.}
\declaremodule{standard}{UserList}
\modulesynopsis{Class wrapper for list objects.}
diff --git a/Doc/lib/libuu.tex b/Doc/lib/libuu.tex
index b052de7..4145823 100644
--- a/Doc/lib/libuu.tex
+++ b/Doc/lib/libuu.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{uu}}
+\section{\module{uu} ---
+ Encode and decode files in uuencode format.}
\declaremodule{standard}{uu}
\modulesynopsis{Encode and decode files in uuencode format.}
diff --git a/Doc/lib/libwhichdb.tex b/Doc/lib/libwhichdb.tex
index db4f555..b3035cf 100644
--- a/Doc/lib/libwhichdb.tex
+++ b/Doc/lib/libwhichdb.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{whichdb}}
+\section{\module{whichdb} ---
+ Guess which DBM-style module created a given database.}
\declaremodule{standard}{whichdb}
\modulesynopsis{Guess which DBM-style module created a given database.}
diff --git a/Doc/lib/libwhrandom.tex b/Doc/lib/libwhrandom.tex
index bc7d402..8df1b77 100644
--- a/Doc/lib/libwhrandom.tex
+++ b/Doc/lib/libwhrandom.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{whrandom}}
+\section{\module{whrandom} ---
+ Floating point pseudo-random number generator.}
\declaremodule{standard}{whrandom}
\modulesynopsis{Floating point pseudo-random number generator.}
diff --git a/Doc/lib/libxdrlib.tex b/Doc/lib/libxdrlib.tex
index 6de8d92..3565eb7 100644
--- a/Doc/lib/libxdrlib.tex
+++ b/Doc/lib/libxdrlib.tex
@@ -1,8 +1,9 @@
-\section{Standard Module \module{xdrlib}}
+\section{\module{xdrlib} ---
+ Encode and decode XDR data.}
\declaremodule{standard}{xdrlib}
\modulesynopsis{Encoders and decoders for the External Data
-Representation.}
+Representation (XDR).}
\index{XDR}
\index{External Data Representation}
diff --git a/Doc/lib/libxmllib.tex b/Doc/lib/libxmllib.tex
index 129ab17..d8aa3ed 100644
--- a/Doc/lib/libxmllib.tex
+++ b/Doc/lib/libxmllib.tex
@@ -1,4 +1,5 @@
-\section{Standard Module \module{xmllib}}
+\section{\module{xmllib} ---
+ A parser for XML documents.}
% Author: Sjoerd Mullender
\declaremodule{standard}{xmllib}
diff --git a/Doc/lib/libzlib.tex b/Doc/lib/libzlib.tex
index 0369507..9dbb16b 100644
--- a/Doc/lib/libzlib.tex
+++ b/Doc/lib/libzlib.tex
@@ -1,7 +1,8 @@
% XXX The module has been extended (by Jeremy) but this documentation
% hasn't been updated completely.
-\section{Built-in Module \module{zlib}}
+\section{\module{zlib} ---
+ Compression and decompression compatible with \program{gzip}.}
\declaremodule{builtin}{zlib}
\modulesynopsis{Low-level interface to compression and decompression
diff --git a/Doc/templates/module.tex b/Doc/templates/module.tex
index e82bb21..cff05d1 100644
--- a/Doc/templates/module.tex
+++ b/Doc/templates/module.tex
@@ -3,26 +3,32 @@
% ==== 1. ====
-% Choose one of the following section headers and index entries;
-% \section generates the section header, \declmodule produces the
-% appropriate index entry for this module. Note that these should
-% only be used for the defining entry for the module. Other
-% references to the module should use \refbimodindex, \refstmodindex,
-% \refexmodindex or \refmodindex, as appropriate.
+% The section prologue. Give the section a title and provide some
+% meta-information. References to the module should use
+% \refbimodindex, \refstmodindex, \refexmodindex or \refmodindex, as
+% appropriate.
-\section{Built-in Module \module{spam}} % If implemented in C, in
-\declaremodule{builtin}{spam} % standard library
+\section{\module{spam} ---
+ Short one-line descrition, for section title.}
-\section{Standard Module \module{spam}} % If implemented in Python, in
-\declaremodule{standard}{spam} % standard library
+% Choose one of these to specify the module module name. If there's
+% an underscore in the name, use
+% \declaremodule[modname]{...}{mod_name} instead.
+%
+\declaremodule{builtin}{spam} % standard library, in C
+\declaremodule{standard}{spam} % standard library, in Python
+\declaremodule{extension}{spam} % not standard, in C
+\declaremodule{}{spam} % not standard, in Python
-\section{Extension Module \module{spam}}% If implemented in C, but not
-\declaremodule{extension}{spam} % in standard library
+% These apply to all modules:
-\section{Module \module{spam}} % If implemented in Python, but not
-\declaremodule{}{spam} % in standard library
+\moduleauthor{name}{email} % Author of the module code;
+ % omit if not known.
+\sectionauthor{name}{email} % Author of the documentation.
+% Leave at least one blank line after this, to simplify ad-hoc tools
+% that are sometimes used to massage these files.
\modulesynopsis{This is a one-line descrition, for the chapter header.}