[Python-checkins] cpython (3.4): some timezone doc improvements (closes #16667)

[benjamin.peterson]

http://hg.python.org/cpython/rev/b32174cad588
changeset:   91335:b32174cad588
branch:      3.4
parent:      91333:4f0480e92ffc
user:        Benjamin Peterson <benjamin at python.org>
date:        Sun Jun 22 16:26:39 2014 -0700
summary:
  some timezone doc improvements (closes #16667)

From the combined efforts of Berber Peksage, Andrew Svetlov, and Yayoi Ukai.

files:
  Doc/library/datetime.rst |  12 +++++++-----
  1 files changed, 7 insertions(+), 5 deletions(-)


diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -1687,11 +1687,11 @@
 .. seealso::
 
    `pytz <http://pypi.python.org/pypi/pytz/>`_
-      The standard library has no :class:`tzinfo` instances except for UTC, but
-      there exists a third-party library which brings the *IANA timezone
-      database* (also known as the Olson database) to Python: *pytz*.
-
-      *pytz* contains up-to-date information and its usage is recommended.
+      The standard library has :class:`timezone` class for handling arbitrary
+      fixed offsets from UTC and :attr:`timezone.utc` as UTC timezone instance.
+
+      *pytz* library brings the *IANA timezone database* (also known as the
+      Olson database) to Python and its usage is recommended.
 
    `IANA timezone database <http://www.iana.org/time-zones>`_
       The Time Zone Database (often called tz or zoneinfo) contains code and
@@ -1728,6 +1728,8 @@
   *offset*, HH and MM are two digits of ``offset.hours`` and
   ``offset.minutes`` respectively.
 
+  .. versionadded:: 3.2
+
 .. method:: timezone.utcoffset(dt)
 
   Return the fixed value specified when the :class:`timezone` instance is

-- 
Repository URL: http://hg.python.org/cpython