From: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Date: Mon, 5 Sep 2022 06:47:47 +0000 (+0100)
Subject: gh-84095: Fill documentation gap regarding user-defined objects. (GH-96574)
X-Git-Tag: v3.12.0a1~479
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a9d58feccfd956dc99195af6872b06446738d7db;p=thirdparty%2FPython%2Fcpython.git

gh-84095: Fill documentation gap regarding user-defined objects. (GH-96574)
---

diff --git a/Doc/library/logging.config.rst b/Doc/library/logging.config.rst
index 9f9361a2fd56..9b82c1f75e3f 100644
--- a/Doc/library/logging.config.rst
+++ b/Doc/library/logging.config.rst
@@ -534,6 +534,25 @@ mnemonic that the corresponding value is a callable.
        The ``filters`` member of ``handlers`` and ``loggers`` can take
        filter instances in addition to ids.
 
+You can also specify a special key ``'.'`` whose value is a dictionary is a
+mapping of attribute names to values. If found, the specified attributes will
+be set on the user-defined object before it is returned. Thus, with the
+following configuration::
+
+    {
+      '()' : 'my.package.customFormatterFactory',
+      'bar' : 'baz',
+      'spam' : 99.9,
+      'answer' : 42,
+      '.' {
+        'foo': 'bar',
+        'baz': 'bozz'
+      }
+    }
+
+the returned formatter will have attribute ``foo`` set to ``'bar'`` and
+attribute ``baz`` set to ``'bozz'``.
+
 
 .. _logging-config-dict-externalobj: