diff --git a/pep-0495.txt b/pep-0495.txt index 11a2477ca..4374fd535 100644 --- a/pep-0495.txt +++ b/pep-0495.txt @@ -343,7 +343,7 @@ The basic implementation of ``fromutc()`` in the abstract ``datetime.tzinfo`` class will not change. It is currently not used anywhere in the stdlib because the only included ``tzinfo`` implementation (the ``datetime.timezone`` class implementing fixed -offset timezones) override ``fromutc()``. Keeping the default +offset timezones) overrides ``fromutc()``. Keeping the default implementation unchanged has the benefit that pre-PEP 3rd party implementations that inherit the default ``fromutc()`` are not accidentally affected. @@ -369,7 +369,7 @@ In the Fold ----------- New subclasses should override the base-class ``fromutc()`` method and -implement it so that in all cases where two UTC times ``u0`` and +implement it so that in all cases where two different UTC times ``u0`` and ``u1`` (``u0`` <``u1``) correspond to the same local time ``t``, ``fromutc(u0)`` will return an instance with ``fold=0`` and ``fromutc(u1)`` will return an instance with ``fold=1``. In all @@ -381,7 +381,7 @@ ambiguous time ``t`` corresponds to the time before or after the transition. By definition, ``utcoffset()`` is greater before and smaller after any transition that creates a fold. The values returned by ``tzname()`` and ``dst()`` may or may not depend on the value of -the fold attribute depending on the kind of the transition. +the ``fold`` attribute depending on the kind of the transition. .. image:: pep-0495-fold-2.png :align: center @@ -695,10 +695,9 @@ The following alternative names have also been considered: **ltdf** (Local Time Disambiguation Flag) - short and no-one will attempt - to guess what it means without reading the docs. (Feel free to - use it in discussions with the meaning ltdf=False is the - earlier if you don't want to endorse any of the alternatives - above.) + to guess what it means without reading the docs. (This abbreviation + was used in PEP discussions with the meaning ``ltdf=False`` is the + earlier by those who didn't want to endorse any of the alternatives.) .. _original: https://mail.python.org/pipermail/python-dev/2015-April/139099.html .. _independently proposed: https://mail.python.org/pipermail/datetime-sig/2015-August/000479.html