Add mktime_tz(). Add () to a function reference in parsedate_tz().

diff --git a/Doc/lib/librfc822.tex b/Doc/lib/librfc822.tex
index 137475522755f6d38ab2844c858e7ca6419c8d43..4e65e918ce6298609c6bb9b91388768583ccf310 100644 (file)
--- a/Doc/lib/librfc822.tex
+++ b/Doc/lib/librfc822.tex
@@ -40,13 +40,21 @@ returned.
 \end{funcdesc}
 
 \begin{funcdesc}{parsedate_tz}{date}
-Performs the same function as \code{parsedate}, but returns either
+Performs the same function as \code{parsedate()}, but returns either
 \code{None} or a 10-tuple; the first 9 elements make up a tuple that
 can be passed directly to \code{time.mktime()}, and the tenth is the
 offset of the date's time zone from UTC (which is the official term
 for Greenwich Mean Time).
 \end{funcdesc}
 
+\begin{funcdesc}{mktime_tz}{tuple}
+Turn a 10-tuple as returned by \code{parsedate_tz()} into a UTC timestamp.
+Minor deficiency: this first interprets the first 8 elements as a
+local time and then compensates for the timezone difference;
+this may yield a slight error around daylight savings time
+switch dates.  Not enough to worry about for common use.
+\end{funcdesc}
+
 \subsection{Message Objects}
 
 A \code{Message} instance has the following methods:

diff --git a/Doc/librfc822.tex b/Doc/librfc822.tex
index 137475522755f6d38ab2844c858e7ca6419c8d43..4e65e918ce6298609c6bb9b91388768583ccf310 100644 (file)
--- a/Doc/librfc822.tex
+++ b/Doc/librfc822.tex
@@ -40,13 +40,21 @@ returned.
 \end{funcdesc}
 
 \begin{funcdesc}{parsedate_tz}{date}
-Performs the same function as \code{parsedate}, but returns either
+Performs the same function as \code{parsedate()}, but returns either
 \code{None} or a 10-tuple; the first 9 elements make up a tuple that
 can be passed directly to \code{time.mktime()}, and the tenth is the
 offset of the date's time zone from UTC (which is the official term
 for Greenwich Mean Time).
 \end{funcdesc}
 
+\begin{funcdesc}{mktime_tz}{tuple}
+Turn a 10-tuple as returned by \code{parsedate_tz()} into a UTC timestamp.
+Minor deficiency: this first interprets the first 8 elements as a
+local time and then compensates for the timezone difference;
+this may yield a slight error around daylight savings time
+switch dates.  Not enough to worry about for common use.
+\end{funcdesc}
+
 \subsection{Message Objects}
 
 A \code{Message} instance has the following methods: