From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 5 Sep 2025 21:32:49 +0000 (+0200)
Subject: [3.13] gh-137985: Correct description of Formatter's datefmt param in logging documen... 
X-Git-Tag: v3.13.8~103
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bb64bc357f0a703c20fb424cb69c59b36be966d6;p=thirdparty%2FPython%2Fcpython.git

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

(cherry picked from commit 83688950490f26d098a462569201ef8e94378852)
Co-authored-by: W. H. Wang <mattwang44@gmail.com>
---

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 72a526dc4d61..1a90fbd8bda1 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.