Commit fee358b0 authored by Vinay Sajip's avatar Vinay Sajip

logging: clarified documentation for Handler.handleError.

parent c3ef037e
...@@ -375,12 +375,14 @@ subclasses. However, the :meth:`__init__` method in subclasses needs to call ...@@ -375,12 +375,14 @@ subclasses. However, the :meth:`__init__` method in subclasses needs to call
.. method:: Handler.handleError(record) .. method:: Handler.handleError(record)
This method should be called from handlers when an exception is encountered 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 during an :meth:`emit` call. If the module-level attribute
exceptions get silently ignored. This is what is mostly wanted for a logging ``raiseExceptions`` is ``False``, exceptions get silently ignored. This is
system - most users will not care about errors in the logging system, they are what is mostly wanted for a logging system - most users will not care about
more interested in application errors. You could, however, replace this with a errors in the logging system, they are more interested in application
custom handler if you wish. The specified record is the one which was being errors. You could, however, replace this with a custom handler if you wish.
processed when the exception occurred. 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) .. method:: Handler.format(record)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment