From e7b4bbe2f69d96a55ed30b1db41c8ac680c618e8 Mon Sep 17 00:00:00 2001 From: PikalaxALT Date: Sun, 20 Sep 2020 00:15:10 -0400 Subject: [PATCH] Add bot.listen() suggestion to on_message faq --- docs/faq.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index 41931d417..55a652398 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -344,6 +344,15 @@ Overriding the default provided ``on_message`` forbids any extra commands from r await bot.process_commands(message) +Alternatively, you can place your ``on_message`` logic into a **listener**. In this setup, you should not +manually call ``bot.process_commands()``. This also allows you to do multiple things asynchronously in response +to a message. Example:: + + @bot.listen('on_message') + async def whatever_you_want_to_call_it(message): + # do stuff here + # do not process commands here + Why do my arguments require quotes? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~