Reword #setEphemeral note

discord-jda · Nov 17, 2024 · 76e95f4 · 76e95f4
1 parent d264a78
commit 76e95f4
Show file tree

Hide file tree

Showing 4 changed files with 12 additions and 8 deletions.
diff --git a/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java b/src/main/java/net/dv8tion/jda/api/interactions/InteractionHook.java
@@ -113,8 +113,9 @@ default boolean isExpired()
      *     <li>Cannot be {@link net.dv8tion.jda.api.entities.channel.middleman.MessageChannel#retrieveMessageById(long) retrieved by ID}</li>
      * </ul>
      *
-     * <b>Note:</b> Your message will always appear ephemeral
-     * if the guild has {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS Permission.USE_EXTERNAL_APPLICATIONS} disabled.
+     * <b>Note:</b> In guilds the bot is not a member of, your message will appear ephemeral
+     * if the member does not have the {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS USE_EXTERNAL_APPLICATIONS} permission,
+     * this usually happens for user-installed commands.
      *
      * @param  ephemeral
      *         True if messages should be ephemeral

diff --git a/src/main/java/net/dv8tion/jda/api/interactions/callbacks/IReplyCallback.java b/src/main/java/net/dv8tion/jda/api/interactions/callbacks/IReplyCallback.java
@@ -94,8 +94,9 @@ public interface IReplyCallback extends IDeferrableCallback
      *     <li>Cannot be {@link net.dv8tion.jda.api.entities.channel.middleman.MessageChannel#retrieveMessageById(long) retrieved by ID}</li>
      * </ul>
      *
-     * <b>Note:</b> Your message will always appear ephemeral
-     * if the guild has {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS Permission.USE_EXTERNAL_APPLICATIONS} disabled.
+     * <b>Note:</b> In guilds the bot is not a member of, your message will appear ephemeral
+     * if the member does not have the {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS USE_EXTERNAL_APPLICATIONS} permission,
+     * this usually happens for user-installed commands.
      *
      * @param  ephemeral
      *         True, if this message should only be visible to the interaction user

diff --git a/src/main/java/net/dv8tion/jda/api/requests/restaction/WebhookMessageCreateAction.java b/src/main/java/net/dv8tion/jda/api/requests/restaction/WebhookMessageCreateAction.java
@@ -55,8 +55,9 @@ public interface WebhookMessageCreateAction<T> extends MessageCreateRequest<Webh
      * the very first message sent through the {@link InteractionHook}, inherits the ephemeral state of the initial reply.
      * To send an ephemeral deferred reply, you must use {@link IReplyCallback#deferReply(boolean) deferReply(true)} instead.
      *
-     * <p><b>Note:</b> Your message will always appear ephemeral
-     * if the guild has {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS Permission.USE_EXTERNAL_APPLICATIONS} disabled.
+     * <p><b>Note:</b> In guilds the bot is not a member of, your message will appear ephemeral
+     * if the member does not have the {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS USE_EXTERNAL_APPLICATIONS} permission,
+     * this usually happens for user-installed commands.
      *
      * @param  ephemeral
      *         True, if this message should be invisible for other users

diff --git a/src/main/java/net/dv8tion/jda/api/requests/restaction/interactions/ReplyCallbackAction.java b/src/main/java/net/dv8tion/jda/api/requests/restaction/interactions/ReplyCallbackAction.java
@@ -45,8 +45,9 @@ public interface ReplyCallbackAction extends InteractionCallbackAction<Interacti
      *     <li>Cannot be {@link net.dv8tion.jda.api.entities.channel.middleman.MessageChannel#retrieveMessageById(long) retrieved by ID}</li>
      * </ul>
      *
-     * <b>Note:</b> Your message will always appear ephemeral
-     * if the guild has {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS Permission.USE_EXTERNAL_APPLICATIONS} disabled.
+     * <b>Note:</b> In guilds the bot is not a member of, your message will appear ephemeral
+     * if the member does not have the {@link net.dv8tion.jda.api.Permission#USE_EXTERNAL_APPLICATIONS USE_EXTERNAL_APPLICATIONS} permission,
+     * this usually happens for user-installed commands.
      *
      * @param  ephemeral
      *         True, if this message should be invisible for other users