xinb
/
zsh-completions
mirror of https://github.com/zsh-users/zsh-completions.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: clarify _regex_arguments example explanation (#1106)

This commit is contained in:
Julian Andres 2026-05-21 12:12:35 -05:00
parent 45e2c02492
commit 570609e9ab
No known key found for this signature in database
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
zsh-completions-howto.org
View File

@ -295,8 +295,10 @@ _regex_arguments _cmd /$'[^\0]##\0'/ \( /$'word1(a|b|c)\0'/ ':word:first word:(w
'|' /$'word22(a|b|c)\0'/ ':word:second word:(word22a word22b word22c)' \) \)
_cmd "$@"
#+END_SRC
in this case the first word can be word1 or word11 followed by an a, b or c, and if the first word contains 11 then a second
word is allowed which can be word2 or word22 followed by and a, b, or c.
In this example, the command itself is matched first (any non-empty word). The first argument
can be either =word1(a|b|c)= or =word11(a|b|c)=. If the first argument matches the =word11=
variant, a second argument becomes available, which can be either =word2(a|b|c)= or
=word22(a|b|c)=.
If this sounds too complicated a much simpler alternative is to use the _regex_words function for creating
specifications for _regex_arguments.