From 45752ab3543a95ffcb6fa866ca91c57b81a4b9a2 Mon Sep 17 00:00:00 2001 From: Rapptz Date: Sat, 22 Aug 2020 17:14:02 -0400 Subject: [PATCH] Document merging behaviour of AllowedMentions in Messageable.send --- discord/abc.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/discord/abc.py b/discord/abc.py index 7704a5f8f..251174f21 100644 --- a/discord/abc.py +++ b/discord/abc.py @@ -827,7 +827,12 @@ class Messageable(metaclass=abc.ABCMeta): before deleting the message we just sent. If the deletion fails, then it is silently ignored. allowed_mentions: :class:`~discord.AllowedMentions` - Controls the mentions being processed in this message. + Controls the mentions being processed in this message. If this is + passed, then the object is merged with :attr:`~discord.Client.allowed_mentions`. + The merging behaviour only overrides attributes that have been explicitly passed + to the object, otherwise it uses the attributes set in :attr:`~discord.Client.allowed_mentions`. + If no object is passed at all then the defaults given by :attr:`~discord.Client.allowed_mentions` + are used instead. .. versionadded:: 1.4