https://github.com/python/cpython/commit/83688950490f26d098a462569201ef8e94378852
commit: 83688950490f26d098a462569201ef8e94378852
branch: main
author: W. H. Wang <[email protected]>
committer: vsajip <[email protected]>
date: 2025-09-05T22:07:04+01:00
summary:
gh-137985: Correct description of Formatter's datefmt param in logging
documentation (GH-138530)
files:
M Doc/library/logging.rst
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index b3017c1ec70032..425025931d9835 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.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
