]> granicus.if.org Git - python/commitdiff
Corrected minor typo and added .currentmodule directives to fix missing cross-references.
authorVinay Sajip <vinay_sajip@yahoo.co.uk>
Sat, 10 Jan 2009 19:23:34 +0000 (19:23 +0000)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>
Sat, 10 Jan 2009 19:23:34 +0000 (19:23 +0000)
Doc/library/logging.rst

index 42b1a05d5e58e908c89d14092360c700b6195c9a..84500c4590d77e4620f15f6fb0fed1f74fc27a05 100644 (file)
@@ -119,7 +119,7 @@ Another useful feature of the logging API is the ability to produce different
 messages at different log levels.  This allows you to instrument your code with
 debug messages, for example, but turning the log level down so that those debug
 messages are not written for your production system.  The default levels are
-``CRITICAL``, ``ERROR``, ``WARNING``, ``INFO``, ``DEBUG`` and ``UNSET``.
+``CRITICAL``, ``ERROR``, ``WARNING``, ``INFO``, ``DEBUG`` and ``NOTSET``.
 
 The logger, handler, and log message call each specify a level.  The log message
 is only emitted if the handler and logger are configured to emit messages of
@@ -421,6 +421,7 @@ 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
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -529,6 +530,8 @@ provided:
 
 #. :class:`FileHandler` instances send error messages to disk files.
 
+.. currentmodule:: logging.handlers
+
 #. :class:`BaseRotatingHandler` is the base class for handlers that rotate log
    files at a certain point. It is not meant to be  instantiated directly. Instead,
    use :class:`RotatingFileHandler` or :class:`TimedRotatingFileHandler`.
@@ -558,6 +561,13 @@ provided:
 #. :class:`HTTPHandler` instances send error messages to an HTTP server using
    either ``GET`` or ``POST`` semantics.
 
+#. :class:`WatchedFileHandler` instances watch the file they are logging to. If
+the file changes, it is closed and reopened using the file name. This handler
+is only useful on Unix-like systems; Windows does not support the underlying
+mechanism used.
+
+.. currentmodule:: logging
+
 #. :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
@@ -1618,8 +1628,6 @@ WatchedFileHandler
 
 .. module:: logging.handlers
 
-.. module:: logging.handlers
-
 The :class:`WatchedFileHandler` class, located in the :mod:`logging.handlers`
 module, is a :class:`FileHandler` which watches the file it is logging to. If
 the file changes, it is closed and reopened using the file name.