[Python-checkins] python/dist/src/Doc/lib libdatetime.tex,1.19,1.20

[tim_one@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv28282/lib

Modified Files:
	libdatetime.tex 
Log Message:
Removed the now-untrue (or soon-to-be untrue) part of the astimezone()
docs.  Replaced it with an XXX block, because the hoped-for treatment
of DST endcases remains unclear (Guido doesn't really like raising an
exception when it's impossible to deliver a correct result, but so
far I have no way in hand to consistently deliver a defined incorrect
result either).


Index: libdatetime.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libdatetime.tex,v
retrieving revision 1.19
retrieving revision 1.20
diff -C2 -d -r1.19 -r1.20
*** libdatetime.tex	31 Dec 2002 14:26:54 -0000	1.19
--- libdatetime.tex	31 Dec 2002 16:01:47 -0000	1.20
***************
*** 209,213 ****
  \begin{tableiii}{c|l|c}{code}{Operation}{Result}{Notes}
    \lineiii{\var{t1} = \var{t2} + \var{t3}}
!           {Sum of \var{t2} and \var{t3}. 
             Afterwards \var{t1}-\var{t2} == \var{t3} and \var{t1}-\var{t3}
             == \var{t2} are true.}
--- 209,213 ----
  \begin{tableiii}{c|l|c}{code}{Operation}{Result}{Notes}
    \lineiii{\var{t1} = \var{t2} + \var{t3}}
!           {Sum of \var{t2} and \var{t3}.
             Afterwards \var{t1}-\var{t2} == \var{t3} and \var{t1}-\var{t3}
             == \var{t2} are true.}
***************
*** 232,236 ****
  	  {equivalent to \class{timedelta}(-\var{t1.days}, -\var{t1.seconds},
  	   -\var{t1.microseconds}),and to \var{t1}* -1.}
! 	  {(1)(3)}	  
    \lineiii{abs(\var{t})}
            {equivalent to +\var{t} when \code{t.days >= 0}, and to -\var{t} when
--- 232,236 ----
  	  {equivalent to \class{timedelta}(-\var{t1.days}, -\var{t1.seconds},
  	   -\var{t1.microseconds}),and to \var{t1}* -1.}
! 	  {(1)(3)}
    \lineiii{abs(\var{t})}
            {equivalent to +\var{t} when \code{t.days >= 0}, and to -\var{t} when
***************
*** 238,242 ****
            {(1)}
  
!     
  \end{tableiii}
  \noindent
--- 238,242 ----
            {(1)}
  
! 
  \end{tableiii}
  \noindent
***************
*** 1259,1269 ****
      \code{tz.utcoffset(self)} does not return \code{None}, the date and
      time fields are adjusted so that the result is local time in timezone
!     tz, representing the same UTC time as self.  \code{self.astimezone(tz)}
!     is then equivalent to
!     \begin{verbatim}
!         (self - (self.utcoffset() - tz.utcoffset(self)).replace(tzinfo=tz)
!     \end{verbatim}
!     where the result of \code{tz.utcoffset(self)} is converted to a
!     \class{timedelta} if it's an integer.
  \end{methoddesc}
  
--- 1259,1266 ----
      \code{tz.utcoffset(self)} does not return \code{None}, the date and
      time fields are adjusted so that the result is local time in timezone
!     tz, representing the same UTC time as self.
!     XXX [The treatment of endcases remains unclear:  for DST-aware
!     classes, one hour per year has two spellings in local time, and
!     another hour has no spelling in local time.] XXX
  \end{methoddesc}