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.
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 @@
\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 @@
\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 @@
\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 @@
\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 @@
\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 @@
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 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 @@
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 @@
\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 @@
\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}