From: John Belmonte <john@neggie.net>
Date: Thu, 26 Jan 2023 07:25:43 +0000 (+0900)
Subject: datetime.rst: improve combine() docs (#101338)
X-Git-Tag: v3.12.0a5~93
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f5ad63f79af3a5876f90b409d0c8402fa54e878a;p=thirdparty%2FPython%2Fcpython.git

datetime.rst: improve combine() docs (#101338)

The explanation on handling of datetime as the date arg was confusingly mixed with an unrelated
item, and lacked proper arg name formatting.
---

diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index eba8824f8351..ebb5f319efda 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -982,12 +982,11 @@ Other constructors, all class methods:
    are equal to the given :class:`.time` object's. If the *tzinfo*
    argument is provided, its value is used to set the :attr:`.tzinfo` attribute
    of the result, otherwise the :attr:`~.time.tzinfo` attribute of the *time* argument
-   is used.
+   is used.  If the *date* argument is a :class:`.datetime` object, its time components
+   and :attr:`.tzinfo` attributes are ignored.
 
    For any :class:`.datetime` object *d*,
-   ``d == datetime.combine(d.date(), d.time(), d.tzinfo)``. If date is a
-   :class:`.datetime` object, its time components and :attr:`.tzinfo` attributes
-   are ignored.
+   ``d == datetime.combine(d.date(), d.time(), d.tzinfo)``.
 
    .. versionchanged:: 3.6
       Added the *tzinfo* argument.