#14766: Reflow the altered paragraphs.

Doc/library/datetime.rst

@@ -12,8 +12,8 @@
 The :mod:`datetime` module supplies classes for manipulating dates and times in
 both simple and complex ways.  While date and time arithmetic is supported, the
 focus of the implementation is on efficient attribute extraction for output
-formatting and manipulation. For related
+formatting and manipulation. For related functionality, see also the
-functionality, see also the :mod:`time` and :mod:`calendar` modules.
+:mod:`time` and :mod:`calendar` modules.
 
 There are two kinds of date and time objects: "naive" and "aware".
 
@@ -25,22 +25,21 @@ interpretation [#]_.
 
 A naive object does not contain enough information to unambiguously locate
 itself relative to other date/time objects.  Whether a naive object represents
-Coordinated Universal Time (UTC),
+Coordinated Universal Time (UTC), local time, or time in some other timezone is
-local time, or time in some other timezone is purely up to the program, just
+purely up to the program, just like it is up to the program whether a
-like it's up to the program whether a particular number represents metres,
+particular number represents metres, miles, or mass.  Naive objects are easy to
-miles, or mass.  Naive objects are easy to understand and to
+understand and to work with, at the cost of ignoring some aspects of reality.
-work with, at the cost of ignoring some aspects of reality.
 
-For applications requiring aware objects, :class:`.datetime` and :class:`.time` objects
+For applications requiring aware objects, :class:`.datetime` and :class:`.time`
-have an optional time zone information attribute, :attr:`tzinfo`, that can be
+objects have an optional time zone information attribute, :attr:`tzinfo`, that
-set to an instance of a subclass of the abstract :class:`tzinfo` class.  These
+can be set to an instance of a subclass of the abstract :class:`tzinfo` class.
-:class:`tzinfo` objects capture information about the offset from UTC time, the
+These :class:`tzinfo` objects capture information about the offset from UTC
-time zone name, and whether Daylight Saving Time is in effect.  Note that only
+time, the time zone name, and whether Daylight Saving Time is in effect.  Note
-one concrete :class:`tzinfo` class, the :class:`timezone` class, is supplied by the
+that only one concrete :class:`tzinfo` class, the :class:`timezone` class, is
-:mod:`datetime` module.  The :class:`timezone` class can represent simple
+supplied by the :mod:`datetime` module.  The :class:`timezone` class can
-timezones with fixed offset from UTC such as UTC itself or North American EST and
+represent simple timezones with fixed offset from UTC, such as UTC itself or
-EDT timezones.  Supporting timezones at deeper levels of detail is
+North American EST and EDT timezones.  Supporting timezones at deeper levels of
-up to the application.  The rules for time adjustment across the
+detail is up to the application.  The rules for time adjustment across the
 world are more political than rational, change frequently, and there is no
 standard suitable for every application aside from UTC.