[Python-checkins] python/nondist/sandbox/datetime doc.txt,1.40,1.41

[tim_one@users.sourceforge.net]

Update of /cvsroot/python/python/nondist/sandbox/datetime
In directory sc8-pr-cvs1:/tmp/cvs-serv16758

Modified Files:
	doc.txt 
Log Message:
Added a subclass tree.


Index: doc.txt
===================================================================
RCS file: /cvsroot/python/python/nondist/sandbox/datetime/doc.txt,v
retrieving revision 1.40
retrieving revision 1.41
diff -C2 -d -r1.40 -r1.41
*** doc.txt	10 Dec 2002 17:01:21 -0000	1.40
--- doc.txt	10 Dec 2002 21:21:13 -0000	1.41
***************
*** 1,6 ****
  TODO/OPEN
  =========
! - Implement a base tzinfo class, capturing the example FixedOffset
!   semantics.  Variant tzinfo classes must subclass from this.
  
  - datetimetz needs a C implementation.
--- 1,6 ----
  TODO/OPEN
  =========
! - Implement an abstract base tzinfo class semantics.  Variant tzinfo
!   classes must subclass from this.
  
  - datetimetz needs a C implementation.
***************
*** 8,17 ****
  - timetz needs a C implementation.
  
! - Subclass relationships.  Currently datetime is a subclass of date.
!   I like this in practice, and think it's theoretically sound too.
!   Should this be blessed?  I expect the same questions to pop up for
!   timetz wrt time, and datetimetz wrt datetime.
!   Guido sez subclassing is fine.  Add docs about the subclass
!   relationships.
  
  - LaTeXize the docs.
--- 8,12 ----
  - timetz needs a C implementation.
  
! - tzinfo needs a C implementation.
  
  - LaTeXize the docs.
***************
*** 22,25 ****
--- 17,28 ----
  CLOSED
  ======
+ - Subclass relationships.  Currently datetime is a subclass of date.
+   I like this in practice, and think it's theoretically sound too.
+   Should this be blessed?  I expect the same questions to pop up for
+   timetz wrt time, and datetimetz wrt datetime.
+   Guido sez subclassing is fine.  Add docs about the subclass
+   relationships.
+   Done.
+ 
  - The METH_CLASS bug affects about a dozen functions here.  They'll need
    to be recoded in minor ways when the bug gets fixed.  The bug needs to
***************
*** 82,99 ****
      time, or whatever else is convenient.
  
  class datetimetz
      Like datetime, but also supports a customizable notion of time
-     adjustment (for timezones, or daylight savings time, or any other
-     computable adjustment).
- 
- class timetz
-     Like time, but also supports a customizable notion of time
      adjustment.
  
! class timedelta
!     A duration, the difference between two datetimes, to microsecond
!     resolution.
  
  Objects of these types are immutable.
  
  
--- 85,118 ----
      time, or whatever else is convenient.
  
+ class timedelta
+     A duration, the difference between two dates, times, or datetimes, to
+     microsecond resolution.
+ 
+ class tzinfo
+     An abstract base class for time zone information objects.  These are
+     used by the datetimetz and timetz classes to provided a customizable
+     notion of time adjustment (for example, to account for time zone
+     and/or daylight savings time).
+ 
  class datetimetz
      Like datetime, but also supports a customizable notion of time
      adjustment.
  
! class timetz
!     Like time, but also supports a customizable notion of time adjustment.
  
  Objects of these types are immutable.
+ 
+ 
+ Subclass relationships
+ ======================
+     object
+         timedelta
+         tzinfo
+         date
+             datetime
+                 datetimetz
+         time
+             timetz