[Python-checkins] cpython (merge 3.2 -> default): Merged documentation update from 3.2.

[vinay.sajip]

http://hg.python.org/cpython/rev/2b4a553bd6ed
changeset:   75063:2b4a553bd6ed
parent:      75057:1f9461ef6312
parent:      75062:a72e0e1d0292
user:        Vinay Sajip <vinay_sajip at yahoo.co.uk>
date:        Mon Feb 20 18:36:12 2012 +0000
summary:
  Merged documentation update from 3.2.

files:
  Doc/library/logging.rst |  14 ++++++++------
  1 files changed, 8 insertions(+), 6 deletions(-)


diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -378,12 +378,14 @@
 .. 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)

-- 
Repository URL: http://hg.python.org/cpython