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

(cherry picked from commit 5d66c55c8ad0a0aeff8d06021ddca1d02c5f4416)

Co-authored-by: UV <yuvrajpradhan667@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 3d84cc70684de3992ac57661748d82003409f4b3..28c90eae822b316f9b0949fcc3d57a73f3031894 100644 (file)
--- 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)