about summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/compsys.yo14
2 files changed, 17 insertions, 2 deletions
diff --git a/ChangeLog b/ChangeLog
index db166f7ee..eb5eb5ed1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2021-11-19  Oliver Kiddle  <opk@zsh.org>
+
+	* Arseny Maslennikov: 49575: Doc/Zsh/compsys.yo:
+	clarify _alternative's action syntax
+
 2021-11-15  Jun-ichi Takimoto  <takimoto-j@kba.biglobe.ne.jp>
 
 	* 49563: Src/Modules/watch.c: fix build problem of watch module
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index e65f2956b..8c6bf9c40 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -3620,8 +3620,18 @@ described using the var(spec)s which are of the form:
 `var(tag)tt(:)var(descr)tt(:)var(action)'.  The var(tag)s are offered using
 tt(_tags) and if the tag is requested, the var(action) is executed with the
 given description var(descr).  The var(action)s are those accepted
-by the tt(_arguments) function (described below), excluding the
-`tt(->)var(state)' and `tt(=)var(...)' forms.
+by the tt(_arguments) function (described below), with the following
+exceptions:
+startitemize()
+itemiz(\
+The `tt(->)var(state)' and `tt(=)var(...)' forms are not supported.
+)
+itemiz(\
+The `tt(LPAR()LPAR()a\:bar b\:baz)tt(RPAR()RPAR())' form does not need
+the colon to be escaped, since the var(spec)s have no colon-separated fields
+after the var(action).
+)
+enditemize()
 
 For example, the var(action) may be a simple function call: