aniani/profanity
1
0
Fork 0
mirror of https://github.com/profanity-im/profanity.git synced 2024-11-03 19:37:16 -05:00
Code

Command doc: Improve description and examples of /bookmark and /join

Browse Source
This commit is contained in:
Maximilian Wuttke 2021-03-21 10:56:19 +01:00
parent cb0adae63a
commit b8f3e8e0ac
1 changed files with 13 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
src/command/cmd_defs.c
View File

@ -575,7 +575,9 @@ static struct cmd_t command_defs[] = {
"If no room is supplied, a generated name will be used with the format private-chat-[UUID]. " "If no room is supplied, a generated name will be used with the format private-chat-[UUID]. "
"If the domain part is not included in the room name, the account preference 'muc.service' will be used. " "If the domain part is not included in the room name, the account preference 'muc.service' will be used. "
"If no nickname is specified the account preference 'muc.nick' will be used which by default is the localpart of your JID. " "If no nickname is specified the account preference 'muc.nick' will be used which by default is the localpart of your JID. "
"If the room doesn't exist, and the server allows it, a new one will be created.") "If the room doesn't exist, and the server allows it, a new one will be created. "
"If you join to a room often, you might also want to add a bookmark (see `/help bookmark`), which also allows to set a default nickname. "
"In this case, you should use `/bookmark join`.")
CMD_ARGS( CMD_ARGS(
{ "<room>", "The chat room to join." }, { "<room>", "The chat room to join." },
{ "nick <nick>", "Nickname to use in the room." }, { "nick <nick>", "Nickname to use in the room." },
@ -820,7 +822,7 @@ static struct cmd_t command_defs[] = {
"/bookmark", "/bookmark",
"/bookmark list", "/bookmark list",
"/bookmark add [<room>] [nick <nick>] [password <password>] [name <roomname>] [autojoin on|off]", "/bookmark add [<room>] [nick <nick>] [password <password>] [name <roomname>] [autojoin on|off]",
"/bookmark update <room> [nick <nick>] [password <password>] [name <roomname>] autojoin on|off]", "/bookmark update <room> [nick <nick>] [password <password>] [name <roomname>] [autojoin on|off]",
"/bookmark remove [<room>]", "/bookmark remove [<room>]",
"/bookmark join <room>", "/bookmark join <room>",
"/bookmark invites on|off", "/bookmark invites on|off",
@ -829,14 +831,14 @@ static struct cmd_t command_defs[] = {
"/bookmark ignore remove <jid>") "/bookmark ignore remove <jid>")
CMD_DESC( CMD_DESC(
"Manage bookmarks and join bookmarked rooms. " "Manage bookmarks and join bookmarked rooms. "
"In a chat room, no arguments will bookmark the current room, setting autojoin to \"on\"." "If you are in a chat room and no arguments are supplied to `/bookmark add`, autojoin is set to \"on\". "
"There is also an autojoin ignore list in case you want to autojoind in many clients but not on Profanity.") "There is also an autojoin ignore list in case you want to autojoin in many clients but not on Profanity. ")
CMD_ARGS( CMD_ARGS(
{ "list", "List all bookmarks." }, { "list", "List all bookmarks." },
{ "add [<room>]", "Add a bookmark, passing no room will bookmark the current room, setting autojoin to \"on\"." }, { "add [<room>]", "Add a bookmark, passing no room will bookmark the current room, setting autojoin to \"on\"." },
{ "remove [<room>]", "Remove a bookmark, passing no room will remove the bookmark for the current room, if one exists." }, { "remove [<room>]", "Remove a bookmark, passing no room will remove the bookmark for the current room, if one exists." },
{ "update <room>", "Update the properties associated with a bookmark." }, { "update <room>", "Update the properties associated with a bookmark." },
{ "nick <nick>", "Nickname used in the chat room." }, { "nick <nick>", "Nickname used when joining the chat room." },
{ "password <password>", "Password if required, may be stored in plaintext on your server." }, { "password <password>", "Password if required, may be stored in plaintext on your server." },
{ "name <roomname>", "Optional name for the bookmark. By default localpart of the JID will be used." }, { "name <roomname>", "Optional name for the bookmark. By default localpart of the JID will be used." },
{ "autojoin on|off", "Whether to join the room automatically on login." }, { "autojoin on|off", "Whether to join the room automatically on login." },
@ -844,7 +846,12 @@ static struct cmd_t command_defs[] = {
{ "invites on|off", "Whether or not to bookmark accepted room invites, defaults to 'on'." }, { "invites on|off", "Whether or not to bookmark accepted room invites, defaults to 'on'." },
{ "ignore add <barejid>", "Add a bookmark to the autojoin ignore list." }, { "ignore add <barejid>", "Add a bookmark to the autojoin ignore list." },
{ "ignore remove <barejid>", "Remove a bookmark from the autojoin ignore list." }) { "ignore remove <barejid>", "Remove a bookmark from the autojoin ignore list." })
CMD_NOEXAMPLES CMD_EXAMPLES(
"/bookmark add room@example.com nick YOURNICK",
"/bookmark join room@example.com",
"/bookmark update room@example.com nick NEWNICK autojoin on",
"/bookmark ignore room@example.com",
"/bookmark remove room@example.com")
}, },
{ "/disco", { "/disco",