From: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Date: Tue, 20 May 2025 16:18:53 +0000 (+0100)
Subject: gh-76075: Correct `datetime.timestamp` documentation (#131202)
X-Git-Tag: v3.15.0a1~1628
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=86397cf65d024a39ae85b81d7f611ad4864a78b4;p=thirdparty%2FPython%2Fcpython.git

gh-76075: Correct `datetime.timestamp` documentation (#131202)

* Clean up timestamp docs

* Update datetime.rst

* Suggestion
---

diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index 3470f42a6c62..16ed3215bc2c 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -1502,11 +1502,11 @@ Instance methods:
    returned by :func:`time.time`.
 
    Naive :class:`.datetime` instances are assumed to represent local
-   time and this method relies on the platform C :c:func:`mktime`
-   function to perform the conversion. Since :class:`.datetime`
-   supports wider range of values than :c:func:`mktime` on many
-   platforms, this method may raise :exc:`OverflowError` or :exc:`OSError`
-   for times far in the past or far in the future.
+   time and this method relies on platform C functions to perform
+   the conversion. Since :class:`.datetime` supports a wider range of
+   values than the platform C functions on many platforms, this
+   method may raise :exc:`OverflowError` or :exc:`OSError` for times
+   far in the past or far in the future.
 
    For aware :class:`.datetime` instances, the return value is computed
    as::
@@ -1519,6 +1519,10 @@ Instance methods:
       The :meth:`timestamp` method uses the :attr:`.fold` attribute to
       disambiguate the times during a repeated interval.
 
+   .. versionchanged:: 3.6
+      This method no longer relies on the platform C :c:func:`mktime`
+      function to perform conversions.
+
    .. note::
 
       There is no method to obtain the POSIX timestamp directly from a