[Python-checkins] python/dist/src/Doc/lib libdatetime.tex, 1.49.8.1, 1.49.8.2

Thu Sep 4 12:30:17 EDT 2003

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv32202/Doc/lib
Modified Files:
 Tag: release23-maint
	libdatetime.tex 
Log Message:
Patch #792338: Correct documentation for timetuple return type.
Index: libdatetime.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libdatetime.tex,v
retrieving revision 1.49.8.1
retrieving revision 1.49.8.2
diff -C2 -d -r1.49.8.1 -r1.49.8.2
*** libdatetime.tex	22 Aug 2003 16:27:03 -0000	1.49.8.1
--- libdatetime.tex	4 Sep 2003 18:30:15 -0000	1.49.8.2
***************
*** 429,441 ****

 \begin{methoddesc}{timetuple}{}
! Return a 9-element tuple of the form returned by
 \function{time.localtime()}. The hours, minutes and seconds are
 0, and the DST flag is -1.
 \code{\var{d}.timetuple()} is equivalent to
! \code{(\var{d}.year, \var{d}.month, \var{d}.day,
 0, 0, 0, 
 \var{d}.weekday(), 
 \var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1,
! -1)}
 \end{methoddesc}

--- 429,441 ----

 \begin{methoddesc}{timetuple}{}
! Return a \class{time.struct_time} such as returned by
 \function{time.localtime()}. The hours, minutes and seconds are
 0, and the DST flag is -1.
 \code{\var{d}.timetuple()} is equivalent to
! \code{time.struct_time((\var{d}.year, \var{d}.month, \var{d}.day,
 0, 0, 0, 
 \var{d}.weekday(), 
 \var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1,
! -1))}
 \end{methoddesc}

***************
*** 859,870 ****

 \begin{methoddesc}{timetuple}{}
! Return a 9-element tuple of the form returned by
 \function{time.localtime()}.
 \code{\var{d}.timetuple()} is equivalent to
! \code{(\var{d}.year, \var{d}.month, \var{d}.day,
 \var{d}.hour, \var{d}.minute, \var{d}.second,
 \var{d}.weekday(),
 \var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1,
! dst)}
 The \member{tm_isdst} flag of the result is set according to
 the \method{dst()} method: if \member{tzinfo} is \code{None} or
--- 859,870 ----

 \begin{methoddesc}{timetuple}{}
! Return a \class{time.struct_time} such as returned by
 \function{time.localtime()}.
 \code{\var{d}.timetuple()} is equivalent to
! \code{time.struct_time((\var{d}.year, \var{d}.month, \var{d}.day,
 \var{d}.hour, \var{d}.minute, \var{d}.second,
 \var{d}.weekday(),
 \var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1,
! dst))}
 The \member{tm_isdst} flag of the result is set according to
 the \method{dst()} method: if \member{tzinfo} is \code{None} or
***************
*** 882,886 ****

 If \var{d} is aware, \var{d} is normalized to UTC time, by subtracting
! \code{\var{d}.utcoffset()}, and a timetuple for the
 normalized time is returned. \member{tm_isdst} is forced to 0.
 Note that the result's \member{tm_year} member may be
--- 882,886 ----

 If \var{d} is aware, \var{d} is normalized to UTC time, by subtracting
! \code{\var{d}.utcoffset()}, and a \class{time.struct_time} for the
 normalized time is returned. \member{tm_isdst} is forced to 0.
 Note that the result's \member{tm_year} member may be