From 4b031a72832ab1a629d2085fb205077271e56174 Mon Sep 17 00:00:00 2001
From: freya02 <41875020+freya022@users.noreply.github.com>
Date: Tue, 10 Dec 2024 15:31:08 +0100
Subject: [PATCH] Reword other `@thrown` DetachedEntityException
---
.../jda/api/entities/IPermissionHolder.java | 42 ++++-----
.../net/dv8tion/jda/api/entities/Role.java | 4 +-
.../channel/attribute/ICopyableChannel.java | 2 +-
.../attribute/IGuildChannelContainer.java | 94 +++++++++----------
4 files changed, 71 insertions(+), 71 deletions(-)
diff --git a/src/main/java/net/dv8tion/jda/api/entities/IPermissionHolder.java b/src/main/java/net/dv8tion/jda/api/entities/IPermissionHolder.java
index 361adfb321..4dc7ac4a3c 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/IPermissionHolder.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/IPermissionHolder.java
@@ -48,7 +48,7 @@ public interface IPermissionHolder extends ISnowflake
*
Changes to the returned set do not affect this entity directly.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a member and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Member#isDetached() detached} member
*
* @return An EnumSet of Permissions granted to this PermissionHolder.
*/
@@ -67,11 +67,11 @@ public interface IPermissionHolder extends ISnowflake
* @throws java.lang.IllegalArgumentException
* If the channel is null
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a role and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Role#isDetached() detached} role
* @throws net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException
- * if this is a member, the bot {@link Guild#isDetached() isn't in the guild},
+ * If this is a {@link Member#isDetached() detached} member,
* and the combination of Member and GuildChannel doesn't have permission data,
- * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}.
+ * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}
*
* @return Set of Permissions granted to this Permission Holder in the specified channel.
*/
@@ -85,7 +85,7 @@ public interface IPermissionHolder extends ISnowflake
*
Changes to the returned set do not affect this entity directly.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a member and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Member#isDetached() detached} member
*
* @return EnumSet of the explicitly granted permissions
*/
@@ -105,11 +105,11 @@ public interface IPermissionHolder extends ISnowflake
* @throws java.lang.IllegalArgumentException
* If the channel is null
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a role and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Role#isDetached() detached} role
* @throws net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException
- * if this is a member, the bot {@link Guild#isDetached() isn't in the guild},
+ * If this is a {@link Member#isDetached() detached} member,
* and the combination of Member and GuildChannel doesn't have permission data,
- * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}.
+ * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}
*
* @return EnumSet of the explicitly granted permissions in the specified channel
*/
@@ -125,7 +125,7 @@ public interface IPermissionHolder extends ISnowflake
* @throws IllegalArgumentException
* If null is provided
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a member and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Member#isDetached() detached} member.
*
* @return True, if all of the specified Permissions are granted to this PermissionHolder.
*/
@@ -141,7 +141,7 @@ public interface IPermissionHolder extends ISnowflake
* @throws IllegalArgumentException
* If null is provided
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a member and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Member#isDetached() detached} member.
*
* @return True, if all of the specified Permissions are granted to this PermissionHolder.
*
@@ -164,11 +164,11 @@ default boolean hasPermission(@Nonnull Collection permissions)
* @throws IllegalArgumentException
* If null is provided
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a role and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Role#isDetached() detached} role
* @throws net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException
- * if this is a member, the bot {@link Guild#isDetached() isn't in the guild},
+ * If this is a {@link Member#isDetached() detached} member,
* and the combination of Member and GuildChannel doesn't have permission data,
- * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}.
+ * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}
*
* @return True, if all of the specified Permissions are granted to this PermissionHolder in the provided GuildChannel.
*
@@ -188,11 +188,11 @@ default boolean hasPermission(@Nonnull Collection permissions)
* @throws IllegalArgumentException
* If null is provided
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a role and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Role#isDetached() detached} role
* @throws net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException
- * if this is a member, the bot {@link Guild#isDetached() isn't in the guild},
+ * If this is a {@link Member#isDetached() detached} member,
* and the combination of Member and GuildChannel doesn't have permission data,
- * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}.
+ * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}
*
* @return True, if all of the specified Permissions are granted to this PermissionHolder in the provided GuildChannel.
*/
@@ -212,11 +212,11 @@ default boolean hasPermission(@Nonnull GuildChannel channel, @Nonnull Collection
* @throws IllegalArgumentException
* If null is provided
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if this is a role and the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this is a {@link Role#isDetached() detached} role
* @throws net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException
- * if this is a member, the bot {@link Guild#isDetached() isn't in the guild},
+ * If this is a {@link Member#isDetached() detached} member,
* and the combination of Member and GuildChannel doesn't have permission data,
- * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}.
+ * see {@link net.dv8tion.jda.api.exceptions.MissingEntityInteractionPermissionsException MissingEntityInteractionPermissionsException}
*
* @return True, if the PermissionHolder has access
*/
@@ -243,7 +243,7 @@ default boolean hasAccess(@Nonnull GuildChannel channel)
* @throws IllegalArgumentException
* If either of the channels is null or not from the same guild as this permission holder
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return True, if the channels can be synced
*/
@@ -261,7 +261,7 @@ default boolean hasAccess(@Nonnull GuildChannel channel)
* @throws IllegalArgumentException
* If the channel is null or not from the same guild as this permission holder
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return True, if the channel can be synced
*/
diff --git a/src/main/java/net/dv8tion/jda/api/entities/Role.java b/src/main/java/net/dv8tion/jda/api/entities/Role.java
index 4d5c699112..a0b36d62d2 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/Role.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/Role.java
@@ -53,7 +53,7 @@ public interface Role extends IMentionable, IPermissionHolder, IDetachableEntity
* @throws IllegalStateException
* If this role is not in the guild cache
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link #isDetached() isn't in the guild}, use {@link #getPermissionsRaw()} instead.
+ * If this role is {@link #isDetached() detached}, use {@link #getPermissionsRaw()} instead
*
* @return The position of this {@link net.dv8tion.jda.api.entities.Role Role} as integer.
*/
@@ -188,7 +188,7 @@ public interface Role extends IMentionable, IPermissionHolder, IDetachableEntity
* @throws java.lang.IllegalArgumentException
* If the specified guild is {@code null}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link #isDetached() isn't in the guild} the role should be copied to.
+ * If the guild the role should be copied to is {@link Guild#isDetached() detached}
*
* @return {@link RoleAction RoleAction}
*
RoleAction with already copied values from the specified {@link net.dv8tion.jda.api.entities.Role Role}
diff --git a/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/ICopyableChannel.java b/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/ICopyableChannel.java
index 60a48f950d..df2c6becae 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/ICopyableChannel.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/ICopyableChannel.java
@@ -64,7 +64,7 @@ public interface ICopyableChannel extends GuildChannel
* @throws net.dv8tion.jda.api.exceptions.PermissionException
* If the currently logged in account does not have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link #isDetached() isn't in the guild} the channel should be copied to.
+ * If the guild the channel should be copied to is {@link Guild#isDetached() detached}
*
* @return A specific {@link ChannelAction ChannelAction}
*
This action allows to set fields for the new GuildChannel before creating it!
diff --git a/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/IGuildChannelContainer.java b/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/IGuildChannelContainer.java
index 04f30d6287..57070180ca 100644
--- a/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/IGuildChannelContainer.java
+++ b/src/main/java/net/dv8tion/jda/api/entities/channel/attribute/IGuildChannelContainer.java
@@ -57,7 +57,7 @@ public interface IGuildChannelContainer
* out more specific types.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link ChannelCacheView}
*/
@@ -81,7 +81,7 @@ public interface IGuildChannelContainer
* @throws IllegalArgumentException
* If null is provided, or the id is not a valid snowflake
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return The casted channel, if it exists and is assignable to the provided class, or null
*/
@@ -108,7 +108,7 @@ default T getChannelById(@Nonnull Class type, @Nonnull String i
* @throws IllegalArgumentException
* If null is provided
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return The casted channel, if it exists and is assignable to the provided class, or null
*/
@@ -147,7 +147,7 @@ default T getChannelById(@Nonnull Class type, long id)
* @throws java.lang.NumberFormatException
* If the provided ID is not a snowflake
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return The GuildChannel or null
*/
@@ -182,7 +182,7 @@ default GuildChannel getGuildChannelById(@Nonnull String id)
* The ID of the channel
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return The GuildChannel or null
*/
@@ -227,7 +227,7 @@ default GuildChannel getGuildChannelById(long id)
* @throws java.lang.NumberFormatException
* If the provided ID is not a snowflake
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return The GuildChannel or null
*/
@@ -267,7 +267,7 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, @Nonnull Str
* The ID of the channel
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return The GuildChannel or null
*/
@@ -294,7 +294,7 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link net.dv8tion.jda.api.utils.cache.SortedSnowflakeCacheView SortedSnowflakeCacheView}
*/
@@ -319,7 +319,7 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, long id)
* Determines if the comparison ignores case when comparing. True - case insensitive.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-empty immutable list of all StageChannel names that match the provided name.
*/
@@ -347,7 +347,7 @@ default List getStageChannelsByName(@Nonnull String name, boolean
* @throws java.lang.NumberFormatException
* If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link StageChannel StageChannel} with matching id.
*/
@@ -372,7 +372,7 @@ default StageChannel getStageChannelById(@Nonnull String id)
* The id of the {@link StageChannel StageChannel}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link StageChannel StageChannel} with matching id.
*/
@@ -399,7 +399,7 @@ default StageChannel getStageChannelById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable List of {@link StageChannel StageChannels}.
*/
@@ -427,7 +427,7 @@ default List getStageChannels()
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link net.dv8tion.jda.api.utils.cache.SnowflakeCacheView SnowflakeCacheView}
*/
@@ -454,7 +454,7 @@ default List getStageChannels()
* Determines if the comparison ignores case when comparing. True - case insensitive.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-empty immutable list of all ThreadChannel names that match the provided name.
*/
@@ -484,7 +484,7 @@ default List getThreadChannelsByName(@Nonnull String name, boolea
* @throws java.lang.NumberFormatException
* If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link ThreadChannel ThreadChannel} with matching id.
*/
@@ -511,7 +511,7 @@ default ThreadChannel getThreadChannelById(@Nonnull String id)
* The id of the {@link ThreadChannel ThreadChannel}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link ThreadChannel ThreadChannel} with matching id.
*/
@@ -539,7 +539,7 @@ default ThreadChannel getThreadChannelById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable List of {@link ThreadChannel ThreadChannels}.
*/
@@ -566,7 +566,7 @@ default List getThreadChannels()
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link net.dv8tion.jda.api.utils.cache.SortedSnowflakeCacheView SortedSnowflakeCacheView}
*/
@@ -593,7 +593,7 @@ default List getThreadChannels()
* @throws java.lang.IllegalArgumentException
* If the provided name is {@code null}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Immutable list of all categories matching the provided name
*/
@@ -621,7 +621,7 @@ default List getCategoriesByName(@Nonnull String name, boolean ignoreC
* @throws java.lang.IllegalArgumentException
* If the provided ID is not a valid {@code long}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link Category Category} for the provided ID.
*/
@@ -646,7 +646,7 @@ default Category getCategoryById(@Nonnull String id)
* The snowflake ID of the wanted Category
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link Category Category} for the provided ID.
*/
@@ -673,7 +673,7 @@ default Category getCategoryById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable list of all {@link Category Categories} in this Guild.
*/
@@ -700,7 +700,7 @@ default List getCategories()
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link net.dv8tion.jda.api.utils.cache.SortedSnowflakeCacheView SortedSnowflakeCacheView}
*/
@@ -725,7 +725,7 @@ default List getCategories()
* Determines if the comparison ignores case when comparing. True - case insensitive.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-empty immutable list of all TextChannels names that match the provided name.
*/
@@ -753,7 +753,7 @@ default List getTextChannelsByName(@Nonnull String name, boolean ig
* @throws java.lang.NumberFormatException
* If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link TextChannel TextChannel} with matching id.
*/
@@ -778,7 +778,7 @@ default TextChannel getTextChannelById(@Nonnull String id)
* The id of the {@link TextChannel TextChannel}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link TextChannel TextChannel} with matching id.
*/
@@ -805,7 +805,7 @@ default TextChannel getTextChannelById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable List of all {@link TextChannel TextChannels} in this Guild.
*/
@@ -832,7 +832,7 @@ default List getTextChannels()
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link net.dv8tion.jda.api.utils.cache.SortedSnowflakeCacheView SortedSnowflakeCacheView}
*/
@@ -857,7 +857,7 @@ default List getTextChannels()
* Determines if the comparison ignores case when comparing. True - case insensitive.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-empty immutable list of all NewsChannels names that match the provided name.
*/
@@ -885,7 +885,7 @@ default List getNewsChannelsByName(@Nonnull String name, boolean ig
* @throws java.lang.NumberFormatException
* If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link NewsChannel NewsChannel} with matching id.
*/
@@ -910,7 +910,7 @@ default NewsChannel getNewsChannelById(@Nonnull String id)
* The id of the {@link NewsChannel NewsChannel}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link NewsChannel NewsChannel} with matching id.
*/
@@ -937,7 +937,7 @@ default NewsChannel getNewsChannelById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable List of all {@link NewsChannel NewsChannels} in this Guild.
*/
@@ -964,7 +964,7 @@ default List getNewsChannels()
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link net.dv8tion.jda.api.utils.cache.SortedSnowflakeCacheView SortedSnowflakeCacheView}
*/
@@ -989,7 +989,7 @@ default List getNewsChannels()
* Determines if the comparison ignores case when comparing. True - case insensitive.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-empty immutable list of all VoiceChannel names that match the provided name.
*/
@@ -1017,7 +1017,7 @@ default List getVoiceChannelsByName(@Nonnull String name, boolean
* @throws java.lang.NumberFormatException
* If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link VoiceChannel VoiceChannel} with matching id.
*/
@@ -1042,7 +1042,7 @@ default VoiceChannel getVoiceChannelById(@Nonnull String id)
* The id of the {@link VoiceChannel VoiceChannel}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link VoiceChannel VoiceChannel} with matching id.
*/
@@ -1069,7 +1069,7 @@ default VoiceChannel getVoiceChannelById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable List of {@link VoiceChannel VoiceChannels}.
*/
@@ -1095,7 +1095,7 @@ default List getVoiceChannels()
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link SnowflakeCacheView SnowflakeCacheView}
*/
@@ -1120,7 +1120,7 @@ default List getVoiceChannels()
* Determines if the comparison ignores case when comparing. True - case insensitive.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-empty immutable list of all ForumChannel names that match the provided name.
*/
@@ -1148,7 +1148,7 @@ default List getForumChannelsByName(@Nonnull String name, boolean
* @throws java.lang.NumberFormatException
* If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link ForumChannel} with matching id.
*/
@@ -1173,7 +1173,7 @@ default ForumChannel getForumChannelById(@Nonnull String id)
* The id of the {@link ForumChannel}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link ForumChannel} with matching id.
*/
@@ -1199,7 +1199,7 @@ default ForumChannel getForumChannelById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable List of {@link ForumChannel}.
*/
@@ -1225,7 +1225,7 @@ default List getForumChannels()
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return {@link SnowflakeCacheView SnowflakeCacheView}
*/
@@ -1250,7 +1250,7 @@ default List getForumChannels()
* Determines if the comparison ignores case when comparing. True - case insensitive.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-empty immutable list of all ForumChannel names that match the provided name.
*/
@@ -1278,7 +1278,7 @@ default List getMediaChannelsByName(@Nonnull String name, boolean
* @throws java.lang.NumberFormatException
* If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link MediaChannel} with matching id.
*/
@@ -1303,7 +1303,7 @@ default MediaChannel getMediaChannelById(@Nonnull String id)
* The id of the {@link MediaChannel}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return Possibly-null {@link MediaChannel} with matching id.
*/
@@ -1329,7 +1329,7 @@ default MediaChannel getMediaChannelById(long id)
* To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
*
* @throws net.dv8tion.jda.api.exceptions.DetachedEntityException
- * if the bot {@link Guild#isDetached() isn't in the guild}.
+ * If this entity is {@link net.dv8tion.jda.api.entities.detached.IDetachableEntity#isDetached() detached}
*
* @return An immutable List of {@link MediaChannel}.
*/