Add additional information on exceptions from time.mktime() and related to
improper time tuples passed to various functions. Based on comments from
Andreas Jung.
diff --git a/Doc/lib/libtime.tex b/Doc/lib/libtime.tex
index 81d1352..6a789dd 100644
--- a/Doc/lib/libtime.tex
+++ b/Doc/lib/libtime.tex
@@ -73,7 +73,6 @@
this, where available).
\item
-
The time tuple as returned by \function{gmtime()},
\function{localtime()}, and \function{strptime()}, and accepted by
\function{asctime()}, \function{mktime()} and \function{strftime()},
@@ -97,6 +96,10 @@
daylight savings flag, passed to \function{mktime()} will usually
result in the correct daylight savings state to be filled in.
+When a tuple with an incorrect length is passed to a function
+expecting a time tuple, or having elements of the wrong type, a
+\exception{TypeError} is raised.
+
\end{itemize}
The module defines the following functions and data items:
@@ -174,7 +177,9 @@
the dst flag if it is unknown) which expresses the time in
\emph{local} time, not UTC. It returns a floating point number, for
compatibility with \function{time()}. If the input value cannot be
-represented as a valid time, \exception{OverflowError} is raised. The
+represented as a valid time, either \exception{OverflowError} or
+\exception{ValueError} will be raised (which depends on whether the
+invalid value is caught by Python or the underlying C libraries). The
earliest date for which it can generate a time is platform-dependent.
\end{funcdesc}