summaryrefslogtreecommitdiffstats
path: root/Doc/howto
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2013-01-07 14:18:19 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2013-01-07 14:18:19 (GMT)
commit0e82fd1f78a9ae07c16b1f57a0f39bc56f798b30 (patch)
tree90b01b36ce3c86483485032048115434832f6eb0 /Doc/howto
parente6dec98e451a9c69eaadacfc34df0daf7d98d789 (diff)
parente50f4d2220c22cc84208ba3f1702ffa4e9df6196 (diff)
downloadcpython-0e82fd1f78a9ae07c16b1f57a0f39bc56f798b30.zip
cpython-0e82fd1f78a9ae07c16b1f57a0f39bc56f798b30.tar.gz
cpython-0e82fd1f78a9ae07c16b1f57a0f39bc56f798b30.tar.bz2
Issue #16884: Merged logging documentation fixes from 3.2.
Diffstat (limited to 'Doc/howto')
-rw-r--r--Doc/howto/logging.rst15
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