summaryrefslogtreecommitdiffstats
path: root/Doc/library/logging.rst
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2009-01-10 13:37:26 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2009-01-10 13:37:26 (GMT)
commit26a2d5e352fc96280559eca9df059b5acf14f5f9 (patch)
tree1397768d9800cd32ed78be88565a15cc2d2d7b45 /Doc/library/logging.rst
parent21027e608a2b1b008231105d6eaf0a04078d395f (diff)
downloadcpython-26a2d5e352fc96280559eca9df059b5acf14f5f9.zip
cpython-26a2d5e352fc96280559eca9df059b5acf14f5f9.tar.gz
cpython-26a2d5e352fc96280559eca9df059b5acf14f5f9.tar.bz2
Minor documentation changes relating to NullHandler, the module used for handlers and references to ConfigParser.
Diffstat (limited to 'Doc/library/logging.rst')
-rw-r--r--Doc/library/logging.rst8
1 files changed, 6 insertions, 2 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 232c5b5..e9675c1 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -420,6 +420,7 @@ 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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -463,6 +464,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.
@@ -560,7 +562,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:: 3.1
@@ -1608,7 +1611,8 @@ for use by library developers.
This method does nothing.
-
+See :ref:`library-config` for more information on how to use
+:class:`NullHandler`.
WatchedFileHandler
^^^^^^^^^^^^^^^^^^