Skip to content

Commit dd441f8

Browse files
committed
Option wording tweaks
1 parent ea14410 commit dd441f8

File tree

1 file changed

+15
-9
lines changed

1 file changed

+15
-9
lines changed

sogs/__main__.py

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -57,26 +57,33 @@
5757
metavar='SESSIONID',
5858
help="Delete the the given Session ID(s) as moderator and admins of the room given by --rooms",
5959
)
60-
actions.add_argument('--set-perms', help="Sets permissions for the room given by --rooms")
60+
actions.add_argument(
61+
'--set-perms',
62+
action='store_true',
63+
help="Sets default or user-specific permissions for the room given by --rooms; specify the "
64+
"permissions using --add-perms or --remove-perms",
65+
)
6166
ap.add_argument(
6267
'--users',
63-
help="Users to set permissions for with --set-perms; if omitted, set global perms",
68+
help="One or more specific users to set permissions for with --set-perms; if omitted then the "
69+
"room default permissions will be set for the given room(s) instead.",
6470
nargs='+',
6571
metavar='SESSIONID',
6672
)
6773
ap.add_argument(
6874
"--add-perms",
69-
help="With --add-room or --set-perms, set these permissions to true; --add-perms=[r][w][u][a]",
75+
help="With --add-room or --set-perms, set these permissions to true; takes a string of 1-4 of "
76+
"the letters \"rwua\" for [r]ead, [w]rite, [u]pload, and [a]ccess.",
7077
)
7178
ap.add_argument(
7279
"--remove-perms",
73-
help="With --add-room or --set-perms, set these permissions to false; "
74-
"--remove-perms=[r][w][u][a]",
80+
help="With --add-room or --set-perms, set these permissions to false; takes the same string as "
81+
"--add-perms, but denies the listed permissions rather than granting them.",
7582
)
7683
ap.add_argument(
7784
"--clear-perms",
78-
help="With --add-room or --set-perms, clear room or user overrides on these permissions; "
79-
"--clear-perms=[r][w][u][a]",
85+
help="With --add-room or --set-perms, clear room or user overrides on these permissions, "
86+
"returning them to the default setting. Takes the same argument as --add-perms.",
8087
)
8188
ap.add_argument(
8289
'--admin',
@@ -90,8 +97,7 @@
9097
help="Room(s) to use when adding/removing moderators/admins or when setting permissions. "
9198
"If a single room name of '+' is given then the user will be added/removed as a global "
9299
"admin/moderator. '+' is not valid for setting permissions. If a single room name "
93-
"of '*' is given then the user is added/removed as an admin/moderator from each of the "
94-
"server's current rooms or the requested permissions are set on each of the rooms.",
100+
"of '*' is given then the changes take effect on each of the server's current rooms.",
95101
)
96102
vis_group = ap.add_mutually_exclusive_group()
97103
vis_group.add_argument(

0 commit comments

Comments
 (0)