diff options
| author | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2016-09-11 12:15:57 (GMT) |
|---|---|---|
| committer | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2016-09-11 12:15:57 (GMT) |
| commit | d0630498c9661e74def90873aee60974b0939e64 (patch) | |
| tree | b35555f482a0e7d532167672631e22c55d011a3f /Doc | |
| parent | eb5b647984403ccb34295c39420d558fc58f3b15 (diff) | |
| parent | 3d639b2c2eb6f2488604c1b7e09e6f435e4dcf6a (diff) | |
| download | cpython-d0630498c9661e74def90873aee60974b0939e64.zip cpython-d0630498c9661e74def90873aee60974b0939e64.tar.gz cpython-d0630498c9661e74def90873aee60974b0939e64.tar.bz2 | |
Closed #26533: Merged update from 3.5.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/logging.config.rst | 19 |
1 files changed, 14 insertions, 5 deletions
diff --git a/Doc/library/logging.config.rst b/Doc/library/logging.config.rst index 794cd22..bf60f17 100644 --- a/Doc/library/logging.config.rst +++ b/Doc/library/logging.config.rst @@ -126,10 +126,10 @@ in :mod:`logging` itself) and defining handlers which are declared either in Starts up a socket server on the specified port, and listens for new configurations. If no port is specified, the module's default :const:`DEFAULT_LOGGING_CONFIG_PORT` is used. Logging configurations will be - sent as a file suitable for processing by :func:`fileConfig`. Returns a - :class:`~threading.Thread` instance on which you can call - :meth:`~threading.Thread.start` to start the server, and which you can - :meth:`~threading.Thread.join` when appropriate. To stop the server, + sent as a file suitable for processing by :func:`dictConfig` or + :func:`fileConfig`. Returns a :class:`~threading.Thread` instance on which + you can call :meth:`~threading.Thread.start` to start the server, and which + you can :meth:`~threading.Thread.join` when appropriate. To stop the server, call :func:`stopListening`. The ``verify`` argument, if specified, should be a callable which should @@ -165,9 +165,18 @@ in :mod:`logging` itself) and defining handlers which are declared either in ``verify`` argument to :func:`listen` to prevent unrecognised configurations from being applied. - .. versionchanged:: 3.4. + .. versionchanged:: 3.4 The ``verify`` argument was added. + .. note:: + + If you want to send configurations to the listener which don't + disable existing loggers, you will need to use a JSON format for + the configuration, which will use :func:`dictConfig` for configuration. + This method allows you to specify ``disable_existing_loggers`` as + ``False`` in the configuration you send. + + .. function:: stopListening() Stops the listening server which was created with a call to :func:`listen`. |