summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2012-02-20 18:36:12 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2012-02-20 18:36:12 (GMT)
commitaa8a62dcc0351282c418bc7be540b1fff113df43 (patch)
tree8ad53195df63a2f2c93f665b4b8e5bb08f20157f
parent0588eac21852d25c8ab1cac09aec9668bc38df9f (diff)
parentfee358b0df547e9451cfb0b3d25980e6cc7177cc (diff)
downloadcpython-aa8a62dcc0351282c418bc7be540b1fff113df43.zip
cpython-aa8a62dcc0351282c418bc7be540b1fff113df43.tar.gz
cpython-aa8a62dcc0351282c418bc7be540b1fff113df43.tar.bz2
Merged documentation update from 3.2.
-rw-r--r--Doc/library/logging.rst14
1 files changed, 8 insertions, 6 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index b0487dd..206b5f6 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -378,12 +378,14 @@ subclasses. However, the :meth:`__init__` method in subclasses needs to call
.. method:: Handler.handleError(record)
This method should be called from handlers when an exception is encountered
- during an :meth:`emit` call. By default it does nothing, which means that
- exceptions get silently ignored. This is what is mostly wanted for a logging
- system - most users will not care about errors in the logging system, they are
- more interested in application errors. You could, however, replace this with a
- custom handler if you wish. The specified record is the one which was being
- processed when the exception occurred.
+ during an :meth:`emit` call. If the module-level attribute
+ ``raiseExceptions`` is ``False``, exceptions get silently ignored. This is
+ what is mostly wanted for a logging system - most users will not care about
+ errors in the logging system, they are more interested in application
+ errors. You could, however, replace this with a custom handler if you wish.
+ The specified record is the one which was being processed when the exception
+ occurred. (The default value of ``raiseExceptions`` is ``True``, as that is
+ more useful during development).
.. method:: Handler.format(record)