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

16 files changed, 40 insertions, 38 deletions

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