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

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)' \) \) '|' /$'word22(a|b|c)\0'/ ':word:second word:(word22a word22b word22c)' \) \)
_cmd "$@" _cmd "$@"
#+END_SRC #+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 In this example, the command itself is matched first (any non-empty word). The first argument
word is allowed which can be word2 or word22 followed by and a, b, or c. 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 If this sounds too complicated a much simpler alternative is to use the _regex_words function for creating
specifications for _regex_arguments. specifications for _regex_arguments.