From 682b86c193e3768b93512a46ed74d8897c8e17b8 Mon Sep 17 00:00:00 2001
From: jack1142 <6032823+jack1142@users.noreply.github.com>
Date: Mon, 9 Sep 2019 21:29:19 +0200
Subject: [PATCH] [Permissions] Possible solution for clearing out usage of
 commands with <who_or_what> (#2992)

* style(permissions): clear out usage of commands with <who_or_what>

* chore(changelog): add towncrier entry

* style(permissions): fix black formatting
---
 changelog.d/permissions/2991.enhance.rst |  1 +
 redbot/cogs/permissions/permissions.py   | 18 ++++++++++++++----
 2 files changed, 15 insertions(+), 4 deletions(-)
 create mode 100644 changelog.d/permissions/2991.enhance.rst

diff --git a/changelog.d/permissions/2991.enhance.rst b/changelog.d/permissions/2991.enhance.rst
new file mode 100644
index 000000000..efb88ab78
--- /dev/null
+++ b/changelog.d/permissions/2991.enhance.rst
@@ -0,0 +1 @@
+Clear out usage of commands with ``<who_or_what>`` argument.
diff --git a/redbot/cogs/permissions/permissions.py b/redbot/cogs/permissions/permissions.py
index 2af4cfc88..2e0aa9422 100644
--- a/redbot/cogs/permissions/permissions.py
+++ b/redbot/cogs/permissions/permissions.py
@@ -277,7 +277,9 @@ class Permissions(commands.Cog):
         await self._permissions_acl_set(ctx, guild_id=ctx.guild.id, update=True)
 
     @checks.is_owner()
-    @permissions.command(name="addglobalrule")
+    @permissions.command(
+        name="addglobalrule", usage="<allow_or_deny> <cog_or_command> <who_or_what>..."
+    )
     async def permissions_addglobalrule(
         self,
         ctx: commands.Context,
@@ -308,7 +310,11 @@ class Permissions(commands.Cog):
 
     @commands.guild_only()
     @checks.guildowner_or_permissions(administrator=True)
-    @permissions.command(name="addserverrule", aliases=["addguildrule"])
+    @permissions.command(
+        name="addserverrule",
+        usage="<allow_or_deny> <cog_or_command> <who_or_what>...",
+        aliases=["addguildrule"],
+    )
     async def permissions_addguildrule(
         self,
         ctx: commands.Context,
@@ -338,7 +344,7 @@ class Permissions(commands.Cog):
         await ctx.send(_("Rule added."))
 
     @checks.is_owner()
-    @permissions.command(name="removeglobalrule")
+    @permissions.command(name="removeglobalrule", usage="<cog_or_command> <who_or_what>...")
     async def permissions_removeglobalrule(
         self,
         ctx: commands.Context,
@@ -361,7 +367,11 @@ class Permissions(commands.Cog):
 
     @commands.guild_only()
     @checks.guildowner_or_permissions(administrator=True)
-    @permissions.command(name="removeserverrule", aliases=["removeguildrule"])
+    @permissions.command(
+        name="removeserverrule",
+        usage="<cog_or_command> <who_or_what>...",
+        aliases=["removeguildrule"],
+    )
     async def permissions_removeguildrule(
         self,
         ctx: commands.Context,