diff options
author | Daniel Shahaf <d.s@daniel.shahaf.name> | 2016-01-18 02:36:39 +0000 |
---|---|---|
committer | Daniel Shahaf <d.s@daniel.shahaf.name> | 2016-01-20 07:49:25 +0000 |
commit | 9df6c728e8e43a20e337debbd17c6509f31f570f (patch) | |
tree | 4c362c53a59d6e60addd8bb93d72add789df49ea | |
parent | cfa8d8bcadbdfdcd976813ef0392539cf3819342 (diff) | |
download | zsh-9df6c728e8e43a20e337debbd17c6509f31f570f.tar.gz zsh-9df6c728e8e43a20e337debbd17c6509f31f570f.tar.xz zsh-9df6c728e8e43a20e337debbd17c6509f31f570f.zip |
37664: docs: Document the completion function _command_names.
-rw-r--r-- | ChangeLog | 5 | ||||
-rw-r--r-- | Completion/Unix/Type/_path_commands | 3 | ||||
-rw-r--r-- | Doc/Zsh/compsys.yo | 6 |
3 files changed, 14 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog index 18ea94f53..3ede08c69 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2016-01-20 Daniel Shahaf <d.s@daniel.shahaf.name> + + * 37664: Completion/Unix/Type/_path_commands, Doc/Zsh/compsys.yo: + docs: Document the completion function _command_names. + 2016-01-19 Peter Stephenson <p.stephenson@samsung.com> * 37693: Src/glob.c: turn Dash into '-' in glob qualifiers. diff --git a/Completion/Unix/Type/_path_commands b/Completion/Unix/Type/_path_commands index 423563c0d..66795ae0f 100644 --- a/Completion/Unix/Type/_path_commands +++ b/Completion/Unix/Type/_path_commands @@ -82,6 +82,9 @@ if [[ -n $need_desc ]]; then else _wanted commands expl 'external command' compadd "$@" -k commands && ret=0 fi +# TODO: this is called from '_command_names -e' which is typically used in +# contexts (such as _env) that don't accept directory names. Should this +# 'if' block move up to the "_command_names -" branch of _command_names? if [[ -o path_dirs ]]; then local -a path_dirs path_dirs=(${^path}/*(/N:t)) diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index d6b180301..9954f30d2 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -4203,6 +4203,12 @@ All arguments after the required field name are passed to tt(compadd) when generating matches from the style value, or to the functions for the fields if they are called. ) +findex(_command_names) +item(tt(_command_names) [ tt(-e) | tt(-) ])( +This function completes words that are valid at command position: names of +aliases, builtins, hashed commands, functions, and so on. With the tt(-e) +flag, only hashed commands are completed. The tt(-) flag is ignored. +) findex(_describe) redef(SPACES)(0)(tt(ifztexi(NOTRANS(@ @ @ @ @ @ @ @ @ @ ))ifnztexi( ))) xitem(tt(_describe )[tt(-12JVx)] [ tt(-oO) | tt(-t) var(tag) ] var(descr) var(name1) [ var(name2) ] [ var(opt) ... ]) |