diff options
author | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2013-01-07 14:19:12 (GMT) |
---|---|---|
committer | Vinay Sajip <vinay_sajip@yahoo.co.uk> | 2013-01-07 14:19:12 (GMT) |
commit | ed6f37cad12073128a52aca2ae1e0ee394352865 (patch) | |
tree | 9afbd3f5a276cb2f5981f69aff560bc1ba4a7e80 /Doc/howto | |
parent | 4e62033b574e9699412ffca5541393f6dc8165fb (diff) | |
parent | 0e82fd1f78a9ae07c16b1f57a0f39bc56f798b30 (diff) | |
download | cpython-ed6f37cad12073128a52aca2ae1e0ee394352865.zip cpython-ed6f37cad12073128a52aca2ae1e0ee394352865.tar.gz cpython-ed6f37cad12073128a52aca2ae1e0ee394352865.tar.bz2 |
Closes #16884: Merged logging documentation fixes from 3.3.
Diffstat (limited to 'Doc/howto')
-rw-r--r-- | Doc/howto/logging.rst | 15 |
1 files changed, 8 insertions, 7 deletions
diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst index 44b2f59..1e8b662 100644 --- a/Doc/howto/logging.rst +++ b/Doc/howto/logging.rst @@ -780,13 +780,14 @@ should have the desired effect. If an organisation produces a number of libraries, then the logger name specified can be 'orgname.foo' rather than just 'foo'. -**PLEASE NOTE:** It is strongly advised that you *do not add any handlers other -than* :class:`~logging.NullHandler` *to your library's loggers*. This is -because the configuration of handlers is the prerogative of the application -developer who uses your library. The application developer knows their target -audience and what handlers are most appropriate for their application: if you -add handlers 'under the hood', you might well interfere with their ability to -carry out unit tests and deliver logs which suit their requirements. +.. note:: It is strongly advised that you *do not add any handlers other + than* :class:`~logging.NullHandler` *to your library's loggers*. This is + because the configuration of handlers is the prerogative of the application + developer who uses your library. The application developer knows their + target audience and what handlers are most appropriate for their + application: if you add handlers 'under the hood', you might well interfere + with their ability to carry out unit tests and deliver logs which suit their + requirements. Logging Levels |