From: UV <yuvrajpradhan667@gmail.com>
Date: Fri, 21 Feb 2025 07:10:04 +0000 (+0530)
Subject: gh-127805: Clarify Formatter initialization in logging.rst. (GH-127850)
X-Git-Tag: v3.14.0a6~328
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5d66c55c8ad0a0aeff8d06021ddca1d02c5f4416;p=thirdparty%2FPython%2Fcpython.git

gh-127805: Clarify Formatter initialization in logging.rst. (GH-127850)
---

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 34bb46f0bb1e..72190e972405 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -562,7 +562,8 @@ subclasses. However, the :meth:`!__init__` method in subclasses needs to call
 
    .. method:: Handler.setFormatter(fmt)
 
-      Sets the :class:`Formatter` for this handler to *fmt*.
+      Sets the formatter for this handler to *fmt*.
+      The *fmt* argument must be a :class:`Formatter` instance or ``None``.
 
 
    .. method:: Handler.addFilter(filter)