users/11575: improved documentation for _all_matches

2 files changed, 14 insertions, 2 deletions

diff --git a/ChangeLog b/ChangeLog
index 9ac8d399b..e36c5e500 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-06-16  Peter Stephenson  <p.w.stephenson@ntlworld.com>
+
+	* users/11575: Doc/Zsh/compsys.yo: document use of
+	additional completers and insert style with _all_matches
+
 2007-06-15  Peter Stephenson  <pws@csr.com>
 
 	* 23553: Doc/Zsh/arith.yo, Doc/Zsh/builtins.yo, Src/exec.c,
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 963e43c96..d5651157b 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -2726,9 +2726,16 @@ bindkey '^Xa' all-matches
 zstyle ':completion:all-matches:*' old-matches only
 zstyle ':completion:all-matches::::' completer _all_matches)
 
-Note that this does not generate completions by itself.  First use
+Note that this does not generate completions by itself:  first use
 any of the standard ways of generating a list of completions,
-then use tt(^Xa) to show all matches.
+then use tt(^Xa) to show all matches.  It is possible instead to
+add a standard completer to the list and request that the
+list of all matches should be directly inserted:
+
+example(zstyle ':completion:all-matches::::' completer _all_matches _complete
+zstyle ':completion:all-matches:*' insert true)
+
+In this case the tt(old-matches) style should not be set.
 )
 findex(_approximate)
 item(tt(_approximate))(