summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2011-04-19 12:58:49 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2011-04-19 12:58:49 (GMT)
commit64e564b8f5de1f1822f051f98d3b247bdd001f74 (patch)
tree5997343b28130aa240e628fe910ec39fd8fff8e0 /Doc
parentff1a73590d13279e0864872bf65e1788a3ad7678 (diff)
parentf97255fd7c1d2b70dfe8032a54ce3ce0daf4cea3 (diff)
downloadcpython-64e564b8f5de1f1822f051f98d3b247bdd001f74.zip
cpython-64e564b8f5de1f1822f051f98d3b247bdd001f74.tar.gz
cpython-64e564b8f5de1f1822f051f98d3b247bdd001f74.tar.bz2
Merged documentation fix from 3.2.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/logging.config.rst23
1 files changed, 17 insertions, 6 deletions
diff --git a/Doc/library/logging.config.rst b/Doc/library/logging.config.rst
index 143916f..bb80a7f 100644
--- a/Doc/library/logging.config.rst
+++ b/Doc/library/logging.config.rst
@@ -74,14 +74,25 @@ in :mod:`logging` itself) and defining handlers which are declared either in
.. versionadded:: 3.2
-.. function:: fileConfig(fname[, defaults])
+.. function:: fileConfig(fname, defaults=None, disable_existing_loggers=True)
- Reads the logging configuration from a :mod:`configparser`\-format file named
- *fname*. This function can be called several times from an application,
- allowing an end user to select from various pre-canned
+ Reads the logging configuration from a :mod:`configparser`\-format file
+ named *fname*. This function can be called several times from an
+ application, allowing an end user to select from various pre-canned
configurations (if the developer provides a mechanism to present the choices
- and load the chosen configuration). Defaults to be passed to the ConfigParser
- can be specified in the *defaults* argument.
+ and load the chosen configuration).
+
+ :param defaults: Defaults to be passed to the ConfigParser can be specified
+ in this argument.
+
+ :param disable_existing_loggers: If specified as ``False``, loggers which
+ exist when this call is made are left
+ alone. The default is ``True`` because this
+ enables old behaviour in a backward-
+ compatible way. This behaviour is to
+ disable any existing loggers unless they or
+ their ancestors are explicitly named in the
+ logging configuration.
.. function:: listen(port=DEFAULT_LOGGING_CONFIG_PORT)