summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornicm <nicm>2020-04-05 08:40:31 +0000
committerNicholas Marriott <nicholas.marriott@gmail.com>2020-04-06 16:03:39 +0100
commit32340172603f03e55fe21071ede93652e560b29a (patch)
tree6a43d2079315c0c5192381835bd496b729f3177c
parent938ad5a98c2a37938ea726a910e640a2a8aa8d26 (diff)
Add an argument to list-commands to show only a single command.
-rw-r--r--cmd-list-keys.c14
-rw-r--r--tmux.17
2 files changed, 16 insertions, 5 deletions
diff --git a/cmd-list-keys.c b/cmd-list-keys.c
index 34ed43bf..7e340516 100644
--- a/cmd-list-keys.c
+++ b/cmd-list-keys.c
@@ -47,8 +47,8 @@ const struct cmd_entry cmd_list_commands_entry = {
.name = "list-commands",
.alias = "lscm",
- .args = { "F:", 0, 0 },
- .usage = "[-F format]",
+ .args = { "F:", 0, 1 },
+ .usage = "[-F format] [command]",
.flags = CMD_STARTSERVER|CMD_AFTERHOOK,
.exec = cmd_list_keys_exec
@@ -317,9 +317,12 @@ cmd_list_keys_commands(struct cmd *self, struct cmdq_item *item)
const struct cmd_entry **entryp;
const struct cmd_entry *entry;
struct format_tree *ft;
- const char *template, *s;
+ const char *template, *s, *command = NULL;
char *line;
+ if (args->argc != 0)
+ command = args->argv[0];
+
if ((template = args_get(args, 'F')) == NULL) {
template = "#{command_list_name}"
"#{?command_list_alias, (#{command_list_alias}),} "
@@ -331,6 +334,11 @@ cmd_list_keys_commands(struct cmd *self, struct cmdq_item *item)
for (entryp = cmd_table; *entryp != NULL; entryp++) {
entry = *entryp;
+ if (command != NULL &&
+ (strcmp(entry->name, command) != 0 &&
+ (entry->alias == NULL ||
+ strcmp(entry->alias, command) != 0)))
+ continue;
format_add(ft, "command_list_name", "%s", entry->name);
if (entry->alias != NULL)
diff --git a/tmux.1 b/tmux.1
index 03950c60..c7b40c16 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1036,9 +1036,12 @@ If
is specified, list only clients connected to that session.
.It Xo Ic list-commands
.Op Fl F Ar format
+.Op Ar command
.Xc
.D1 (alias: Ic lscm )
-List the syntax of all commands supported by
+List the syntax of
+.Ar command
+or - if omitted - of all commands supported by
.Nm .
.It Ic list-sessions Op Fl F Ar format
.D1 (alias: Ic ls )
@@ -2710,7 +2713,7 @@ command.
.It Xo Ic list-keys
.Op Fl 1aN
.Op Fl P Ar prefix-string Fl T Ar key-table
-.Op key
+.Op Ar key
.Xc
.D1 (alias: Ic lsk )
List key bindings.