From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 16 Sep 2025 13:55:29 +0000 (+0200)
Subject: [3.14] gh-137985: Correct description of Formatter's datefmt param in logging documen... 
X-Git-Tag: v3.14.0rc3~16
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=35ce9a2867205f5598531ec611b40695a790fc88;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-137985: Correct description of Formatter's datefmt param in logging documentation (GH-138530) (#138565)

Co-authored-by: W. H. Wang <mattwang44@gmail.com>
---

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 79d8673a7e76..dd92e73b88ec 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -671,8 +671,7 @@ Formatter Objects
        which is just the logged message.
    :type fmt: str
 
-   :param datefmt: A format string in the given *style* for
-       the date/time portion of the logged output.
+   :param datefmt: A format string for the date/time portion of the logged output.
        If not specified, the default described in :meth:`formatTime` is used.
    :type datefmt: str
 
@@ -680,7 +679,7 @@ Formatter Objects
        how the format string will be merged with its data: using one of
        :ref:`old-string-formatting` (``%``), :meth:`str.format` (``{``)
        or :class:`string.Template` (``$``). This only applies to
-       *fmt* and *datefmt* (e.g. ``'%(message)s'`` versus ``'{message}'``),
+       *fmt* (e.g. ``'%(message)s'`` versus ``'{message}'``),
        not to the actual log messages passed to the logging methods.
        However, there are :ref:`other ways <formatting-styles>`
        to use ``{``- and ``$``-formatting for log messages.