Fix documentation linking issue in Messageables and Context
This commit is contained in:
Rapptz
@@ -695,11 +695,11 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
be provided.
|
||||
|
||||
To upload a single file, the ``file`` parameter should be used with a
|
||||
single :class:`File` object. To upload multiple files, the ``files``
|
||||
parameter should be used with a :class:`list` of :class:`File` objects.
|
||||
single :class:`.File` object. To upload multiple files, the ``files``
|
||||
parameter should be used with a :class:`list` of :class:`.File` objects.
|
||||
**Specifying both parameters will lead to an exception**.
|
||||
|
||||
If the ``embed`` parameter is provided, it must be of type :class:`Embed` and
|
||||
If the ``embed`` parameter is provided, it must be of type :class:`.Embed` and
|
||||
it must be a rich embed type.
|
||||
|
||||
Parameters
|
||||
@@ -708,11 +708,11 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
The content of the message to send.
|
||||
tts: bool
|
||||
Indicates if the message should be sent using text-to-speech.
|
||||
embed: :class:`Embed`
|
||||
embed: :class:`.Embed`
|
||||
The rich embed for the content.
|
||||
file: :class:`File`
|
||||
file: :class:`.File`
|
||||
The file to upload.
|
||||
files: List[:class:`File`]
|
||||
files: List[:class:`.File`]
|
||||
A list of files to upload. Must be a maximum of 10.
|
||||
nonce: int
|
||||
The nonce to use for sending this message. If the message was successfully sent,
|
||||
@@ -724,17 +724,17 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
|
||||
Raises
|
||||
--------
|
||||
HTTPException
|
||||
:exc:`.HTTPException`
|
||||
Sending the message failed.
|
||||
Forbidden
|
||||
:exc:`.Forbidden`
|
||||
You do not have the proper permissions to send the message.
|
||||
InvalidArgument
|
||||
:exc:`.InvalidArgument`
|
||||
The ``files`` list is not of the appropriate size or
|
||||
you specified both ``file`` and ``files``.
|
||||
|
||||
Returns
|
||||
---------
|
||||
:class:`Message`
|
||||
:class:`.Message`
|
||||
The message that was sent.
|
||||
"""
|
||||
|
||||
@@ -815,27 +815,27 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
async def get_message(self, id):
|
||||
"""|coro|
|
||||
|
||||
Retrieves a single :class:`Message` from the destination.
|
||||
Retrieves a single :class:`.Message` from the destination.
|
||||
|
||||
This can only be used by bot accounts.
|
||||
|
||||
Parameters
|
||||
------------
|
||||
id: int
|
||||
id: :class:`int`
|
||||
The message ID to look for.
|
||||
|
||||
Returns
|
||||
--------
|
||||
:class:`Message`
|
||||
:class:`.Message`
|
||||
The message asked for.
|
||||
|
||||
Raises
|
||||
--------
|
||||
NotFound
|
||||
:exc:`.NotFound`
|
||||
The specified message was not found.
|
||||
Forbidden
|
||||
:exc:`.Forbidden`
|
||||
You do not have the permissions required to get a message.
|
||||
HTTPException
|
||||
:exc:`.HTTPException`
|
||||
Retrieving the message failed.
|
||||
"""
|
||||
|
||||
@@ -846,11 +846,11 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
async def pins(self):
|
||||
"""|coro|
|
||||
|
||||
Returns a :class:`list` of :class:`Message` that are currently pinned.
|
||||
Returns a :class:`list` of :class:`.Message` that are currently pinned.
|
||||
|
||||
Raises
|
||||
-------
|
||||
HTTPException
|
||||
:exc:`.HTTPException`
|
||||
Retrieving the pinned messages failed.
|
||||
"""
|
||||
|
||||
@@ -860,7 +860,7 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
return [state.create_message(channel=channel, data=m) for m in data]
|
||||
|
||||
def history(self, *, limit=100, before=None, after=None, around=None, reverse=None):
|
||||
"""Return an :class:`AsyncIterator` that enables receiving the destination's message history.
|
||||
"""Return an :class:`.AsyncIterator` that enables receiving the destination's message history.
|
||||
|
||||
You must have :attr:`~.Permissions.read_message_history` permissions to use this.
|
||||
|
||||
@@ -868,17 +868,17 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
|
||||
Parameters
|
||||
-----------
|
||||
limit: Optional[int]
|
||||
limit: Optional[:class:`int`]
|
||||
The number of messages to retrieve.
|
||||
If ``None``, retrieves every message in the channel. Note, however,
|
||||
that this would make it a slow operation.
|
||||
before: :class:`Message` or `datetime`
|
||||
before: :class:`.Message` or :class:`datetime.datetime`
|
||||
Retrieve messages before this date or message.
|
||||
If a date is provided it must be a timezone-naive datetime representing UTC time.
|
||||
after: :class:`Message` or `datetime`
|
||||
after: :class:`.Message` or :class:`datetime.datetime`
|
||||
Retrieve messages after this date or message.
|
||||
If a date is provided it must be a timezone-naive datetime representing UTC time.
|
||||
around: :class:`Message` or `datetime`
|
||||
around: :class:`.Message` or :class:`datetime.datetime`
|
||||
Retrieve messages around this date or message.
|
||||
If a date is provided it must be a timezone-naive datetime representing UTC time.
|
||||
When using this argument, the maximum limit is 101. Note that if the limit is an
|
||||
@@ -891,14 +891,14 @@ class Messageable(metaclass=abc.ABCMeta):
|
||||
|
||||
Raises
|
||||
------
|
||||
Forbidden
|
||||
:exc:`.Forbidden`
|
||||
You do not have permissions to get channel message history.
|
||||
HTTPException
|
||||
:exc:`.HTTPException`
|
||||
The request to get message history failed.
|
||||
|
||||
Yields
|
||||
-------
|
||||
:class:`Message`
|
||||
:class:`.Message`
|
||||
The message with the message data parsed.
|
||||
|
||||
Examples
|
||||
|
||||
@@ -38,7 +38,7 @@ class Context(discord.abc.Messageable):
|
||||
|
||||
Attributes
|
||||
-----------
|
||||
message: :class:`discord.Message`
|
||||
message: :class:`.Message`
|
||||
The message that triggered the command being executed.
|
||||
bot: :class:`.Bot`
|
||||
The bot that contains the command being executed.
|
||||
@@ -204,22 +204,22 @@ class Context(discord.abc.Messageable):
|
||||
|
||||
@discord.utils.cached_property
|
||||
def channel(self):
|
||||
"""Returns the channel associated with this context's command. Shorthand for :attr:`Message.channel`."""
|
||||
"""Returns the channel associated with this context's command. Shorthand for :attr:`.Message.channel`."""
|
||||
return self.message.channel
|
||||
|
||||
@discord.utils.cached_property
|
||||
def author(self):
|
||||
"""Returns the author associated with this context's command. Shorthand for :attr:`Message.author`"""
|
||||
"""Returns the author associated with this context's command. Shorthand for :attr:`.Message.author`"""
|
||||
return self.message.author
|
||||
|
||||
@discord.utils.cached_property
|
||||
def me(self):
|
||||
"""Similar to :attr:`Guild.me` except it may return the :class:`ClientUser` in private message contexts."""
|
||||
"""Similar to :attr:`.Guild.me` except it may return the :class:`.ClientUser` in private message contexts."""
|
||||
return self.guild.me if self.guild is not None else self.bot.user
|
||||
|
||||
@property
|
||||
def voice_client(self):
|
||||
r"""Optional[:class:`VoiceClient`]: A shortcut to :attr:`Guild.voice_client`\, if applicable."""
|
||||
r"""Optional[:class:`.VoiceClient`]: A shortcut to :attr:`.Guild.voice_client`\, if applicable."""
|
||||
g = self.guild
|
||||
return g.voice_client if g else None
|
||||
|
||||
|
||||
Reference in New Issue
Block a user