summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Doc/library/logging.handlers.rst7
1 files changed, 6 insertions, 1 deletions
diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
index d5944ec..32919c1 100644
--- a/Doc/library/logging.handlers.rst
+++ b/Doc/library/logging.handlers.rst
@@ -980,7 +980,12 @@ possible, while any potentially slow operations (such as sending an email via
.. method:: emit(record)
- Enqueues the result of preparing the LogRecord.
+ Enqueues the result of preparing the LogRecord. Should an exception
+ occur (e.g. because a bounded queue has filled up), the
+ :meth:`~logging.Handler.handleError` method is called to handle the
+ error. This can result in the record silently being dropped (if
+ :attr:`logging.raiseExceptions` is ``False``) or a message printed to
+ ``sys.stderr`` (if :attr:`logging.raiseExceptions` is ``True``).
.. method:: prepare(record)