summaryrefslogtreecommitdiffstats
path: root/Doc/lib
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-10-18 17:43:06 (GMT)
committerFred Drake <fdrake@acm.org>2000-10-18 17:43:06 (GMT)
commitba0a9899880849f05ab22190147528b0ea054f5a (patch)
treecf5f9e87a2158cd1dc6c9605acd9b022ce9f444a /Doc/lib
parent510dfbad3d94e1137b161e972a9fb6811fcb6ad5 (diff)
downloadcpython-ba0a9899880849f05ab22190147528b0ea054f5a.zip
cpython-ba0a9899880849f05ab22190147528b0ea054f5a.tar.gz
cpython-ba0a9899880849f05ab22190147528b0ea054f5a.tar.bz2
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.
Diffstat (limited to 'Doc/lib')
-rw-r--r--Doc/lib/libarray.tex6
-rw-r--r--Doc/lib/libbase64.tex4
-rw-r--r--Doc/lib/libbinhex.tex4
-rw-r--r--Doc/lib/libgzip.tex3
-rw-r--r--Doc/lib/librand.tex4
-rw-r--r--Doc/lib/libsymbol.tex12
-rw-r--r--Doc/lib/libtoken.tex5
-rw-r--r--Doc/lib/libuser.tex3
-rw-r--r--Doc/lib/libuu.tex4
-rw-r--r--Doc/lib/libzlib.tex2
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}