_menu

_menu

[Oliver Kiddle]

The documentation implies that _menu is nothing more than an example.
However, it has the side effect of disabling menu selection which can
be useful if you want pure menu completion in an _generic based widget.
The result is a lot tidier than adjusting your select style to exclude
a bunch of widgets. So this adjusts the documentation to mention that
use for it.

Index: Doc/Zsh/compsys.yo
===================================================================
RCS file: /cvsroot/zsh/zsh/Doc/Zsh/compsys.yo,v
retrieving revision 1.172
diff -u -r1.172 compsys.yo
--- Doc/Zsh/compsys.yo	21 Jul 2003 17:01:44 -0000	1.172
+++ Doc/Zsh/compsys.yo	20 Sep 2003 22:42:47 -0000
@@ -2784,12 +2784,13 @@
 )
 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)