summaryrefslogtreecommitdiff
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
parentcd38cd40f7f81bee21c14157fc45540d538965bd (diff)
downloadzsh-fb9ec18e9a78c1100fa4cad540498a848d404114.tar.gz
zsh-fb9ec18e9a78c1100fa4cad540498a848d404114.zip
make handling of default tag clearer in the docs (3101)
-rw-r--r--ChangeLog3
-rw-r--r--Doc/Zsh/compsys.yo14
2 files changed, 15 insertions, 2 deletions
diff --git a/ChangeLog b/ChangeLog
index d86045f0a..3c46c87fb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
2000-05-29 Sven Wischnowsky <wischnow@zsh.org>
+ * users/3101: Doc/Zsh/compsys.yo: make handling of default tag clearer
+ in the docs
+
* 11634: Src/Zle/compcore.c, Src/Zle/compmatch.c, Src/Zle/compresult.c:
matching bugs with patterns with two anchors
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