summaryrefslogtreecommitdiffstats
path: root/Doc/howto/logging.rst
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2011-01-04 13:58:49 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2011-01-04 13:58:49 (GMT)
commit2427ab9d6f132224d6ee4a2b7f00b9d69ba6c0a3 (patch)
tree9c2fbfb749303f7f38cb236d4a0d1cfffc1179eb /Doc/howto/logging.rst
parentdc5554008f939e719760b490812065456e8313b5 (diff)
downloadcpython-2427ab9d6f132224d6ee4a2b7f00b9d69ba6c0a3.zip
cpython-2427ab9d6f132224d6ee4a2b7f00b9d69ba6c0a3.tar.gz
cpython-2427ab9d6f132224d6ee4a2b7f00b9d69ba6c0a3.tar.bz2
logging HOWTO: fixed markup for numbered handler list.
Diffstat (limited to 'Doc/howto/logging.rst')
-rw-r--r--Doc/howto/logging.rst34
1 files changed, 15 insertions, 19 deletions
diff --git a/Doc/howto/logging.rst b/Doc/howto/logging.rst
index 21b5cbc..f0d88dc 100644
--- a/Doc/howto/logging.rst
+++ b/Doc/howto/logging.rst
@@ -857,50 +857,46 @@ provided:
#. :class:`FileHandler` instances send messages to disk files.
-.. currentmodule:: logging.handlers
-
-#. :class:`BaseRotatingHandler` is the base class for handlers that
+#. :class:`~handlers.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`.
+ directly. Instead, use :class:`~handlers.RotatingFileHandler` or
+ :class:`~handlers.TimedRotatingFileHandler`.
-#. :class:`RotatingFileHandler` instances send messages to disk
+#. :class:`~handlers.RotatingFileHandler` instances send messages to disk
files, with support for maximum log file sizes and log file rotation.
-#. :class:`TimedRotatingFileHandler` instances send messages to
+#. :class:`~handlers.TimedRotatingFileHandler` instances send messages to
disk files, rotating the log file at certain timed intervals.
-#. :class:`SocketHandler` instances send messages to TCP/IP
+#. :class:`~handlers.SocketHandler` instances send messages to TCP/IP
sockets.
-#. :class:`DatagramHandler` instances send messages to UDP
+#. :class:`~handlers.DatagramHandler` instances send messages to UDP
sockets.
-#. :class:`SMTPHandler` instances send messages to a designated
+#. :class:`~handlers.SMTPHandler` instances send messages to a designated
email address.
-#. :class:`SysLogHandler` instances send messages to a Unix
+#. :class:`~handlers.SysLogHandler` instances send messages to a Unix
syslog daemon, possibly on a remote machine.
-#. :class:`NTEventLogHandler` instances send messages to a
+#. :class:`~handlers.NTEventLogHandler` instances send messages to a
Windows NT/2000/XP event log.
-#. :class:`MemoryHandler` instances send messages to a buffer
+#. :class:`~handlers.MemoryHandler` instances send messages to a buffer
in memory, which is flushed whenever specific criteria are met.
-#. :class:`HTTPHandler` instances send messages to an HTTP
+#. :class:`~handlers.HTTPHandler` instances send messages to an HTTP
server using either ``GET`` or ``POST`` semantics.
-#. :class:`WatchedFileHandler` instances watch the file they are
+#. :class:`~handlers.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.
-#. :class:`QueueHandler` instances send messages to a queue, such as
+#. :class:`~handlers.QueueHandler` instances send messages to a queue, such as
those implemented in the :mod:`queue` or :mod:`multiprocessing` modules.
-.. 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
@@ -911,7 +907,7 @@ provided:
The :class:`NullHandler` class.
.. versionadded:: 3.2
- The :class:`~logging.handlers.QueueHandler` class.
+ The :class:`~handlers.QueueHandler` class.
The :class:`NullHandler`, :class:`StreamHandler` and :class:`FileHandler`
classes are defined in the core logging package. The other handlers are