From: W. H. Wang <mattwang44@gmail.com>
Date: Fri, 5 Sep 2025 21:07:04 +0000 (+0800)
Subject: gh-137985: Correct description of Formatter's datefmt param in logging documentation... 
X-Git-Tag: v3.15.0a1~474
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=83688950490f26d098a462569201ef8e94378852;p=thirdparty%2FPython%2Fcpython.git

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

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index b3017c1ec700..425025931d98 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.