Fix an amazing number of typos & malformed sentences reported by Detlef
Lannert <lannert@uni-duesseldorf.de>.
diff --git a/Doc/lib/libbisect.tex b/Doc/lib/libbisect.tex
index 246d6c7..e36cf0e 100644
--- a/Doc/lib/libbisect.tex
+++ b/Doc/lib/libbisect.tex
@@ -15,9 +15,8 @@
of items with expensive comparison operations, this can be an
improvement over the more common approach. The module is called
\module{bisect} because it uses a basic bisection algorithm to do its
-work. The source code may be used a useful reference for a working
-example of the algorithm (i.e., the boundary conditions are already
-right!).
+work. The source code may be most useful as a working example of the
+algorithm (i.e., the boundary conditions are already right!).
The following functions are provided:
diff --git a/Doc/lib/liblocale.tex b/Doc/lib/liblocale.tex
index d70ffcf..d95b733 100644
--- a/Doc/lib/liblocale.tex
+++ b/Doc/lib/liblocale.tex
@@ -7,8 +7,8 @@
The \code{locale} module opens access to the \POSIX{} locale database
-and functionality. The \POSIX{} locale mechanism allows applications
-to integrate certain cultural aspects into an applications, without
+and functionality. The \POSIX{} locale mechanism allows programmers
+to deal with certain cultural issues in an application, without
requiring the programmer to know all the specifics of each country
where the software is executed.
@@ -270,7 +270,7 @@
characteristics, and then restore the \samp{C} numeric locale.
When Python code uses the \module{locale} module to change the locale,
-this also affect the embedding application. If the embedding
+this also affects the embedding application. If the embedding
application doesn't want this to happen, it should remove the
\module{_locale} extension module (which does all the work) from the
table of built-in modules in the \file{config.c} file, and make sure
diff --git a/Doc/lib/libposixpath.tex b/Doc/lib/libposixpath.tex
index e467e46..bf843d1 100644
--- a/Doc/lib/libposixpath.tex
+++ b/Doc/lib/libposixpath.tex
@@ -54,9 +54,11 @@
unchanged.
\end{funcdesc}
-\begin{funcdesc}{getsize}{path}
-Return the size, in bytes, of \var{filename}. Raise
-\exception{os.error} if the file does not exist or is inaccessible.
+\begin{funcdesc}{getatime}{path}
+Return the time of last access of \var{filename}. The return
+value is integer giving the number of seconds since the epoch (see the
+\refmodule{time} module). Raise \exception{os.error} if the file does
+not exist or is inaccessible.
\versionadded{1.5.2}
\end{funcdesc}
@@ -68,11 +70,9 @@
\versionadded{1.5.2}
\end{funcdesc}
-\begin{funcdesc}{getatime}{path}
-Return the time of last access of \var{filename}. The return
-value is integer giving the number of seconds since the epoch (see the
-\refmodule{time} module). Raise \exception{os.error} if the file does
-not exist or is inaccessible.
+\begin{funcdesc}{getsize}{path}
+Return the size, in bytes, of \var{filename}. Raise
+\exception{os.error} if the file does not exist or is inaccessible.
\versionadded{1.5.2}
\end{funcdesc}
diff --git a/Doc/lib/libsyslog.tex b/Doc/lib/libsyslog.tex
index 70a05be..1068db9 100644
--- a/Doc/lib/libsyslog.tex
+++ b/Doc/lib/libsyslog.tex
@@ -39,7 +39,7 @@
\end{funcdesc}
\begin{funcdesc}{setlogmask}{maskpri}
-This function set the priority mask to \var{maskpri} and returns the
+Set the priority mask to \var{maskpri} and return the
previous mask value. Calls to \function{syslog()} with a priority
level not set in \var{maskpri} are ignored. The default is to log all
priorities. The function \code{LOG_MASK(\var{pri})} calculates the
@@ -48,6 +48,7 @@
to and including \var{pri}.
\end{funcdesc}
+
The module defines the following constants:
\begin{description}
diff --git a/Doc/lib/libtime.tex b/Doc/lib/libtime.tex
index 0e14f4c..82007f7 100644
--- a/Doc/lib/libtime.tex
+++ b/Doc/lib/libtime.tex
@@ -35,7 +35,7 @@
integer; this variable is initialized to \code{1} unless the
environment variable \envvar{PYTHONY2K} is set to a non-empty string,
in which case it is initialized to \code{0}. Thus, you can set
-\envvar{PYTHONY2K} in the environment to \code{x} to require 4-digit
+\envvar{PYTHONY2K} to a non-empty string in the environment to require 4-digit
years for all year input. When 2-digit years are accepted, they are
converted according to the \POSIX{} or X/Open standard: values 69-99
are mapped to 1969-1999, and values 0--68 are mapped to 2000--2068.
diff --git a/Doc/lib/libuser.tex b/Doc/lib/libuser.tex
index 484af7e..9e9c6ed 100644
--- a/Doc/lib/libuser.tex
+++ b/Doc/lib/libuser.tex
@@ -57,7 +57,7 @@
program-specific customization file.
Programs with security or privacy concerns should \emph{not} import
-this module; a user can easily break into a a program by placing
+this module; a user can easily break into a program by placing
arbitrary code in the \file{.pythonrc.py} file.
Modules for general use should \emph{not} import this module; it may
diff --git a/Doc/lib/libxmllib.tex b/Doc/lib/libxmllib.tex
index 0a097f4..b19da6d 100644
--- a/Doc/lib/libxmllib.tex
+++ b/Doc/lib/libxmllib.tex
@@ -75,7 +75,7 @@
\begin{methoddesc}{translate_references}{data}
Translate all entity and character references in \var{data} and
-returns the translated string.
+return the translated string.
\end{methoddesc}
\begin{methoddesc}{handle_xml}{encoding, standalone}