about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorSven Wischnowsky <wischnow@users.sourceforge.net>2000-05-29 12:52:20 +0000
committerSven Wischnowsky <wischnow@users.sourceforge.net>2000-05-29 12:52:20 +0000
commitfb9ec18e9a78c1100fa4cad540498a848d404114 (patch)
tree106603279939e5c0cc8e41f0a9334606c9cdfd70 /Doc/Zsh
parentcd38cd40f7f81bee21c14157fc45540d538965bd (diff)
downloadzsh-fb9ec18e9a78c1100fa4cad540498a848d404114.tar.gz
zsh-fb9ec18e9a78c1100fa4cad540498a848d404114.tar.xz
zsh-fb9ec18e9a78c1100fa4cad540498a848d404114.zip
make handling of default tag clearer in the docs (3101)
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/compsys.yo14
1 files changed, 12 insertions, 2 deletions
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 1e5ffa584..217090790 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -491,7 +491,8 @@ for cursor names used by X programs
 kindex(default, completion tag)
 item(tt(default))(
 used to look up default values for various styles that may also be set 
-for tags that are used when generating matches
+for tags that are used when generating matches; note that this tag is
+used when only the var(function) field of the context name is set up
 )
 kindex(descriptions, completion tag)
 item(tt(descriptions))(
@@ -762,6 +763,15 @@ unless the description for the particular style mentions other
 possible values; in particular, the default value may be either on or off
 if the style is not set.
 
+Some of these styles are tested for every tag used to add possible
+matches and for the tt(default) tag (most notably tt(menu),
+tt(list-colors) and the styles controlling the completion listing like 
+tt(list-packed) and tt(last-prompt)). When tested for the tt(default)
+tag, only the var(function) field of the context will be set up, so
+the default value will normally be set like:
+
+example(zstyle ':completion:*:default' menu ...)
+
 startitem()
 kindex(accept-exact, completion style)
 item(tt(accept-exact))(
@@ -1477,7 +1487,7 @@ kindex(menu, completion style)
 item(tt(menu))(
 If this is set to true in a given context, using any of the tags defined
 for a given completion, menu completion will be used.  The tag
-`tt(default)' can be used to match any tag, but a specific tag will take
+`tt(default)' can be used to set the default value, but a specific tag will take
 precedence.  If none of the values found in this way is true but at least
 one is set to `tt(auto)' the behaviour will be as for the tt(AUTO_MENU)
 option.  Finally, if one of the values is explicitly set to false, menu