summaryrefslogtreecommitdiffstats
path: root/Doc/library/logging.rst
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2009-01-10 13:38:04 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2009-01-10 13:38:04 (GMT)
commit99505c841e7edd4992bf9c3c31530ef74e0f862d (patch)
treeb81894480042494bc3f9ba025cbd01fe77801f5a /Doc/library/logging.rst
parentabb70e9c9f79dd26e71368f9aab77ad72d0706bc (diff)
downloadcpython-99505c841e7edd4992bf9c3c31530ef74e0f862d.zip
cpython-99505c841e7edd4992bf9c3c31530ef74e0f862d.tar.gz
cpython-99505c841e7edd4992bf9c3c31530ef74e0f862d.tar.bz2
Minor documentation changes cross-referencing NullHandler to the documentation on configuring logging in a library.
Diffstat (limited to 'Doc/library/logging.rst')
-rw-r--r--Doc/library/logging.rst9
1 files changed, 8 insertions, 1 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 1c6127f..4ab3bea 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -422,6 +422,8 @@ You can see that the config file approach has a few advantages over the Python
code approach, mainly separation of configuration and code and the ability of
noncoders to easily modify the logging properties.
+.. _library-config:
+
Configuring Logging for a Library
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -465,6 +467,7 @@ just "foo".
The :class:`NullHandler` class was not present in previous versions, but is now
included, so that it need not be defined in library code.
+See :ref:`library-config` for more information.
@@ -562,7 +565,8 @@ provided:
#. :class:`NullHandler` instances do nothing with error messages. They are used
by library developers who want to use logging, but want to avoid the "No
handlers could be found for logger XXX" message which can be displayed if
- the library user has not configured logging.
+ the library user has not configured logging. See :ref:`library-config` for
+ more information.
.. versionadded:: 2.7
@@ -1633,6 +1637,9 @@ for use by library developers.
This method does nothing.
+See :ref:`library-config` for more information on how to use
+:class:`NullHandler`.
+
WatchedFileHandler
^^^^^^^^^^^^^^^^^^