Make all the \seemodule explanations consistent: start with a capitalized

letter and end with proper punctuation.  "Documenting Python" will be
updated accordingly so that this will be editorial policy for the Python
documentation.

10 files changed, 27 insertions, 20 deletions

diff --git a/Doc/lib/libarray.tex b/Doc/lib/libarray.tex
index d6f5b5c..1574b1f 100644
--- a/Doc/lib/libarray.tex
+++ b/Doc/lib/libarray.tex
@@ -185,8 +185,10 @@ array('d', [1.0, 2.0, 3.14])
 
 
 \begin{seealso}
-  \seemodule{struct}{packing and unpacking of heterogeneous binary data}
-  \seemodule{xdrlib}{packing and unpacking of XDR data}
+  \seemodule{struct}{Packing and unpacking of heterogeneous binary data.}
+  \seemodule{xdrlib}{Packing and unpacking of External Data
+                     Representation (XDR) data as used in some remote
+                     procedure call systems.}
   \seetitle[http://numpy.sourceforge.net/numdoc/numdoc.pdf]{The
            Numerical Python Manual}{The Numeric Python extension
            (NumPy) defines another array type; see
diff --git a/Doc/lib/libbase64.tex b/Doc/lib/libbase64.tex
index bede708..b608a8a 100644
--- a/Doc/lib/libbase64.tex
+++ b/Doc/lib/libbase64.tex
@@ -50,8 +50,8 @@ base64 encoded data.
 
 
 \begin{seealso}
-  \seemodule{binascii}{support module containing \ASCII{}-to-binary
-                       and binary-to-\ASCII{} conversions}
+  \seemodule{binascii}{Support module containing \ASCII{}-to-binary
+                       and binary-to-\ASCII{} conversions.}
   \seetext{Internet \rfc{1521}, \emph{MIME (Multipurpose Internet
            Mail Extensions) Part One: Mechanisms for Specifying and
            Describing the Format of Internet Message Bodies}, section
diff --git a/Doc/lib/libbinhex.tex b/Doc/lib/libbinhex.tex
index e181798..4afc362 100644
--- a/Doc/lib/libbinhex.tex
+++ b/Doc/lib/libbinhex.tex
@@ -29,8 +29,8 @@ binhex file.
 
 
 \begin{seealso}
-  \seemodule{binascii}{support module containing \ASCII{}-to-binary
-                       and binary-to-\ASCII{} conversions}
+  \seemodule{binascii}{Support module containing \ASCII-to-binary
+                       and binary-to-\ASCII{} conversions.}
 \end{seealso}
 
 
diff --git a/Doc/lib/libgzip.tex b/Doc/lib/libgzip.tex
index 3df75ce..34ec897 100644
--- a/Doc/lib/libgzip.tex
+++ b/Doc/lib/libgzip.tex
@@ -65,5 +65,6 @@ argument is required; \var{mode} defaults to \code{'rb'} and
 \end{funcdesc}
 
 \begin{seealso}
-\seemodule{zlib}{the basic data compression module}
+  \seemodule{zlib}{The basic data compression module needed to support
+                   the \program{gzip} file format.}
 \end{seealso}
diff --git a/Doc/lib/librand.tex b/Doc/lib/librand.tex
index e335718..9b2c685 100644
--- a/Doc/lib/librand.tex
+++ b/Doc/lib/librand.tex
@@ -26,6 +26,6 @@ can be an arbitrary integer.
 \end{funcdesc}
 
 \begin{seealso}
-\seemodule{whrandom}{the standard Python random number generator}
+  \seemodule{random}{Python's interface to random number generators.}
+  \seemodule{whrandom}{The random number generator used by default.}
 \end{seealso}
-
diff --git a/Doc/lib/libsymbol.tex b/Doc/lib/libsymbol.tex
index f963b53..54cabeb 100644
--- a/Doc/lib/libsymbol.tex
+++ b/Doc/lib/libsymbol.tex
@@ -16,13 +16,15 @@ to may change between Python versions.
 This module also provides one additional data object:
 
 
-
 \begin{datadesc}{sym_name}
-Dictionary mapping the numeric values of the constants defined in this
-module back to name strings, allowing more human-readable
-representation of parse trees to be generated.
+  Dictionary mapping the numeric values of the constants defined in
+  this module back to name strings, allowing more human-readable
+  representation of parse trees to be generated.
 \end{datadesc}
 
+
 \begin{seealso}
-\seemodule{parser}{second example uses this module}
+  \seemodule{parser}{The second example for the \refmodule{parser}
+                     module shows how to use the \module{symbol}
+                     module.}
 \end{seealso}
diff --git a/Doc/lib/libtoken.tex b/Doc/lib/libtoken.tex
index a15a78c..47f4750 100644
--- a/Doc/lib/libtoken.tex
+++ b/Doc/lib/libtoken.tex
@@ -36,6 +36,9 @@ Return true for non-terminal token values.
 Return true if \var{x} is the marker indicating the end of input.
 \end{funcdesc}
 
+
 \begin{seealso}
-\seemodule{parser}{second example uses this module}
+  \seemodule{parser}{The second example for the \refmodule{parser}
+                     module shows how to use the \module{symbol}
+                     module.}
 \end{seealso}
diff --git a/Doc/lib/libuser.tex b/Doc/lib/libuser.tex
index 4a79a54..b2735bb 100644
--- a/Doc/lib/libuser.tex
+++ b/Doc/lib/libuser.tex
@@ -65,6 +65,5 @@ Modules for general use should \emph{not} import this module; it may
 interfere with the operation of the importing program.
 
 \begin{seealso}
-\seemodule{site}{site-wide customization mechanism}
-\refstmodindex{site}
+  \seemodule{site}{Site-wide customization mechanism.}
 \end{seealso}
diff --git a/Doc/lib/libuu.tex b/Doc/lib/libuu.tex
index b6dc318..ea4a9e4 100644
--- a/Doc/lib/libuu.tex
+++ b/Doc/lib/libuu.tex
@@ -39,6 +39,6 @@ for \var{out_file} and \var{mode} are taken from the uuencode header.
 
 
 \begin{seealso}
-  \seemodule{binascii}{support module containing \ASCII{}-to-binary
-                       and binary-to-\ASCII{} conversions}
+  \seemodule{binascii}{Support module containing \ASCII-to-binary
+                       and binary-to-\ASCII{} conversions.}
 \end{seealso}
diff --git a/Doc/lib/libzlib.tex b/Doc/lib/libzlib.tex
index 0b3dd09..1da7f78 100644
--- a/Doc/lib/libzlib.tex
+++ b/Doc/lib/libzlib.tex
@@ -148,7 +148,7 @@ action is to delete the object.
 \end{methoddesc}
 
 \begin{seealso}
-  \seemodule{gzip}{reading and writing \program{gzip}-format files}
+  \seemodule{gzip}{Reading and writing \program{gzip}-format files.}
   \seeurl{http://www.info-zip.org/pub/infozip/zlib/}{The
           zlib library home page.}
 \end{seealso}