Fixed lots of small nits caught by Ka-Ping Yee <ping@lfw.org>.

Doc/lib/libcmd.tex

@@ -1,10 +1,9 @@
 \section{\module{cmd} ---
-         Build line-oriented command interpreters.}
+         Support for line-oriented command interpreters}
+
 \declaremodule{standard}{cmd}
 \sectionauthor{Eric S. Raymond}{esr@snark.thyrsus.com}
-
-\modulesynopsis{Build line-oriented command interpreters; this is used
-by module \module{pdb}.}
+\modulesynopsis{Build line-oriented command interpreters.}
 
 
 The \class{Cmd} class provides a simple framework for writing

Doc/lib/libcurses.tex

@@ -1,10 +1,11 @@
 \section{\module{curses} ---
-         Screen painting and input handling for character-cell terminals}
+         Terminal handling for character-cell displays}
 
 \declaremodule{standard}{curses}
 \sectionauthor{Moshe Zadka}{mzadka@geocities.com}
 \sectionauthor{Eric Raymond}{esr@thyrsus.com}
-\modulesynopsis{An interface to the curses library.}
+\modulesynopsis{An interface to the curses library, providing portable
+                terminal handling.}
 
 \versionchanged[Added support for the \code{ncurses} library and
                 converted to a package]{1.6}

Doc/lib/libdis.tex

@@ -1,8 +1,9 @@
 \section{\module{dis} ---
-         Disassembler.}
-\declaremodule{standard}{dis}
+         Disassembler for Python byte code}
 
-\modulesynopsis{Disassembler.}
+\declaremodule{standard}{dis}
+\modulesynopsis{Disassembler for Python byte code, as stored in code
+                objects and \file{.pyc}/\file{.pyo} files.}
 
 
 The \module{dis} module supports the analysis of Python byte code by

Doc/lib/liberrno.tex

@@ -1,12 +1,11 @@
 \section{\module{errno} ---
-         Standard errno system symbols.}
-\declaremodule{standard}{errno}
+         Standard errno system symbols}
 
+\declaremodule{standard}{errno}
 \modulesynopsis{Standard errno system symbols.}
 
 
-
-This module makes available standard errno system symbols.
+This module makes available standard \code{errno} system symbols.
 The value of each symbol is the corresponding integer value.
 The names and descriptions are borrowed from \file{linux/include/errno.h},
 which should be pretty all-inclusive.
@@ -21,8 +20,9 @@ To translate a numeric error code to an error message, use
 \function{os.strerror()}.
 
 Of the following list, symbols that are not used on the current
-platform are not defined by the module.  Symbols available can
-include:
+platform are not defined by the module.  The specific list of defined
+symbols is available as \code{errno.errorcode.keys()}.  Symbols
+available can include:
 
 \begin{datadesc}{EPERM} Operation not permitted \end{datadesc}
 \begin{datadesc}{ENOENT} No such file or directory \end{datadesc}

Doc/lib/libgetopt.tex

@@ -1,8 +1,9 @@
 \section{\module{getopt} ---
-         Parser for command line options.}
-\declaremodule{standard}{getopt}
+         Parser for command line options}
 
-\modulesynopsis{Parser for command line options.}
+\declaremodule{standard}{getopt}
+\modulesynopsis{Portable parser for command line options; support both
+                short and long option names.}
 
 
 This module helps scripts to parse the command line arguments in

Doc/lib/libimghdr.tex

@@ -1,8 +1,9 @@
 \section{\module{imghdr} ---
-         Determine the type of an image.}
-\declaremodule{standard}{imghdr}
+         Determine the type of an image}
 
-\modulesynopsis{Determine the type of image contained in a file or byte stream.}
+\declaremodule{standard}{imghdr}
+\modulesynopsis{Determine the type of image contained in a file or
+                byte stream.}
 
 
 The \module{imghdr} module determines the type of image contained in a

Doc/lib/libnew.tex

@@ -1,5 +1,5 @@
 \section{\module{new} ---
-         Runtime implementation object creation}
+         Creation of runtime internal objects}
 
 \declaremodule{builtin}{new}
 \sectionauthor{Moshe Zadka}{mzadka@geocities.com}

Doc/lib/libpprint.tex

@@ -1,5 +1,5 @@
 \section{\module{pprint} ---
-         Data pretty printer.}
+         Data pretty printer}
 
 \declaremodule{standard}{pprint}
 \modulesynopsis{Data pretty printer.}

Doc/lib/libqueue.tex

@@ -1,11 +1,10 @@
 \section{\module{Queue} ---
-         A synchronized queue class.}
+         A synchronized queue class}
+
 \declaremodule{standard}{Queue}
-
 \modulesynopsis{A synchronized queue class.}
 
 
-
 The \module{Queue} module implements a multi-producer, multi-consumer
 FIFO queue.  It is especially useful in threads programming when
 information must be exchanged safely between multiple threads.  The

Doc/lib/libreadline.tex

@@ -4,7 +4,7 @@
 \declaremodule{builtin}{readline}
   \platform{Unix}
 \sectionauthor{Skip Montanaro}{skip@mojam.com}
-\modulesynopsis{GNU Readline in Python.}
+\modulesynopsis{GNU readline support for Python.}
 
 
 The \module{readline} module defines a number of functions used either

Doc/lib/librepr.tex

@@ -1,5 +1,5 @@
 \section{\module{repr} ---
-         Alternate \function{repr()} implementation.}
+         Alternate \function{repr()} implementation}
 
 \sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
 \declaremodule{standard}{repr}

Doc/lib/librlcompleter.tex

@@ -1,10 +1,10 @@
 \section{\module{rlcompleter} ---
-         Completion function for readline}
+         Completion function for GNU readline}
 
 \declaremodule{standard}{rlcompleter}
   \platform{Unix}
 \sectionauthor{Moshe Zadka}{mzadka@geocities.com}
-\modulesynopsis{Python identifier completion in the readline library.}
+\modulesynopsis{Python identifier completion for the GNU readline library.}
 
 The \module{rlcompleter} module defines a completion function for
 the \refmodule{readline} module by completing valid Python identifiers

Doc/lib/librotor.tex

@@ -1,7 +1,7 @@
 \section{\module{rotor} ---
-         Enigma-like encryption and decryption.}
-\declaremodule{builtin}{rotor}
+         Enigma-like encryption and decryption}
 
+\declaremodule{builtin}{rotor}
 \modulesynopsis{Enigma-like encryption and decryption.}
 
 

Doc/lib/libsignal.tex

@@ -1,10 +1,10 @@
 \section{\module{signal} ---
-         Set handlers for asynchronous events.}
+         Set handlers for asynchronous events}
+
 \declaremodule{builtin}{signal}
-
-
 \modulesynopsis{Set handlers for asynchronous events.}
 
+
 This module provides mechanisms to use signal handlers in Python.
 Some general rules for working with signals and their handlers:
 

Doc/lib/libsndhdr.tex

@@ -1,5 +1,5 @@
 \section{\module{sndhdr} ---
-         Determine type of sound file.}
+         Determine type of sound file}
 
 \declaremodule{standard}{sndhdr}
 \modulesynopsis{Determine type of a sound file.}

Doc/lib/libsocksvr.tex

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