19106: document use for _menu

2 files changed, 11 insertions, 6 deletions

diff --git a/ChangeLog b/ChangeLog
index 7e22c83ad..969622a74 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2003-09-21  Oliver Kiddle  <opk@zsh.org>
+
+	* 19106: Doc/Zsh/compsys.yo: document use for _menu
+
 2003-09-17  Vin Shelton  <acs@alumni.princeton.edu>
 
 	* 19087: Doc/Zsh/mod_system.yo: Fix up makeinfo warning.
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 6b77fb8f8..9322f61c3 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -2784,12 +2784,13 @@ not be used.
 )
 findex(_menu)
 item(tt(_menu))(
-This completer is a simple example function implemented to show how
-menu completion can be done in shell code.  It should be used as the
-first completer and has the effect of making later completers perform
-menu completion.  Note that this is independent of the setting of the
-tt(MENU_COMPLETE) option and does not work with the other
-menu completion widgets such as tt(reverse-menu-complete), or
+This completer was written as simple example function to show how menu
+completion can be enabled in shell code. However, it has the notable
+effect of disabling menu selection which can be useful with
+tt(_generic) based widgets. It should be used as the first completer in
+the list.  Note that this is independent of the setting of the
+tt(MENU_COMPLETE) option and does not work with the other menu
+completion widgets such as tt(reverse-menu-complete), or
 tt(accept-and-menu-complete).
 )
 findex(_oldlist)