aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorVexs <[email protected]>2020-08-14 08:16:03 -0500
committerGitHub <[email protected]>2020-08-14 09:16:03 -0400
commit8252b1f88472d732c99b4bb9788f5871a61825f4 (patch)
treef6488ec5dc3b85c8604c9d2775fde7140a3fa5ac /docs
parentVersion bump to 1.4.1 (diff)
downloaddiscord.py-8252b1f88472d732c99b4bb9788f5871a61825f4.tar.xz
discord.py-8252b1f88472d732c99b4bb9788f5871a61825f4.zip
Document on_error "special" behavior
Diffstat (limited to 'docs')
-rw-r--r--docs/api.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/api.rst b/docs/api.rst
index 8fdd32c4..21f94d58 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -195,6 +195,14 @@ to handle it, which defaults to print a traceback and ignoring the exception.
:ref:`py:raise`. Exceptions raised by ``on_error`` will not be
handled in any way by :class:`Client`.
+ .. note::
+
+ ``on_error`` will only be dispatched to :meth:`Client.event`.
+
+ It will not be received by :meth:`Client.wait_for`, or, if used,
+ :ref:`ext_commands_api_bot` listeners such as
+ :meth:`~ext.commands.Bot.listen` or :meth:`~ext.commands.Cog.listener`.
+
:param event: The name of the event that raised the exception.
:type event: :class:`str`