From 10af1ea25523a898d03eb45a0a2bb4cdbcc41bdd Mon Sep 17 00:00:00 2001
From: zephyrkul <zephyrkul@users.noreply.github.com>
Date: Thu, 28 Apr 2022 10:54:55 -0600
Subject: [PATCH] Document behavior for empty default permissions

---
 discord/app_commands/commands.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/discord/app_commands/commands.py b/discord/app_commands/commands.py
index 2b52982e5..9620bbcb3 100644
--- a/discord/app_commands/commands.py
+++ b/discord/app_commands/commands.py
@@ -468,6 +468,8 @@ class Command(Generic[GroupT, P, T]):
     default_permissions: Optional[:class:`~discord.Permissions`]
         The default permissions that can execute this command on Discord. Note
         that server administrators can override this value in the client.
+        Setting an empty permissions field will disallow anyone except server
+        administrators from using the command in a guild.
 
         Due to a Discord limitation, this does not work on subcommands.
     guild_only: :class:`bool`
@@ -874,6 +876,8 @@ class ContextMenu:
     default_permissions: Optional[:class:`~discord.Permissions`]
         The default permissions that can execute this command on Discord. Note
         that server administrators can override this value in the client.
+        Setting an empty permissions field will disallow anyone except server
+        administrators from using the command in a guild.
     guild_only: :class:`bool`
         Whether the command should only be usable in guild contexts.
         Defaults to ``False``.
@@ -1025,6 +1029,8 @@ class Group:
     default_permissions: Optional[:class:`~discord.Permissions`]
         The default permissions that can execute this group on Discord. Note
         that server administrators can override this value in the client.
+        Setting an empty permissions field will disallow anyone except server
+        administrators from using the command in a guild.
 
         Due to a Discord limitation, this does not work on subcommands.
     guild_only: :class:`bool`
@@ -1828,6 +1834,9 @@ def default_permissions(**perms: bool) -> Callable[[T], T]:
     However, an administrator can change the permissions needed to execute this command using the official
     client. Therefore, this only serves as a hint.
 
+    Setting an empty permissions field, including via calling this with no arguments, will disallow anyone
+    except server administrators from using the command in a guild.
+
     This is sent to Discord server side, and is not a :func:`check`. Therefore, error handlers are not called.
 
     Due to a Discord limitation, this decorator does nothing in subcommands and is ignored.