about summary refs log tree commit diff
diff options
context:
space:
mode:
authorBarton E. Schaefer <schaefer@zsh.org>2014-03-03 23:51:12 -0800
committerBarton E. Schaefer <schaefer@zsh.org>2014-03-03 23:51:12 -0800
commite6d99759e8aff6f17ff08d977c7e7471ac0ebec5 (patch)
treea3ec9cf1ffeaede36d05cd395e22c04ae19f3b8a
parent965d7305e57b9b1a009af71368fcbf6da4e756a8 (diff)
downloadzsh-e6d99759e8aff6f17ff08d977c7e7471ac0ebec5.tar.gz
zsh-e6d99759e8aff6f17ff08d977c7e7471ac0ebec5.tar.xz
zsh-e6d99759e8aff6f17ff08d977c7e7471ac0ebec5.zip
users/18550: matcher-list documentation clarifications
-rw-r--r--ChangeLog6
-rw-r--r--Doc/Zsh/compsys.yo12
2 files changed, 12 insertions, 6 deletions
diff --git a/ChangeLog b/ChangeLog
index 1cd1431d5..7ae7e8740 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2014-03-03  Barton E. Schaefer  <schaefer@zsh.org>
+
+	* users/18550: Doc/Zsh/compsys.yo: matcher-list clarifications
+
 2014-03-01  Peter Stephenson  <p.w.stephenson@ntlworld.com>
 
 	* 32453: Functions/Misc/zcalc: fix default base handling.
@@ -104,7 +108,7 @@
 
 	* 32361: Src/Zle/zle_tricky.c: don't reset lastline before completion
 
-2014-02-13  Barton E. Schaefer  <schaefer@brasslantern.com>
+2014-02-13  Barton E. Schaefer  <schaefer@zsh.org>
 
 	* 32377: Test/comptest: change keybindings and PTY control for
 	vi-mode tests to make them more reliable
diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index c304461e2..7dacbcf7b 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -1995,11 +1995,11 @@ only be performed with the `tt(*)' inserted.
 kindex(matcher, completion style)
 item(tt(matcher))(
 This style is tested separately for each tag valid in the current
-context.  Its value is added to any match specifications given by the 
+context.  Its value is tried before any match specifications given by the 
 tt(matcher-list) style.  It should be in the form described in
 ifzman(the section `Completion Matching Control' in zmanref(zshcompwid))\
 ifnzman(noderef(Completion Matching Control))\
-.
+.  For examples of this, see the description of the tt(tag-order) style.
 )
 kindex(matcher-list, completion style)
 item(tt(matcher-list))(
@@ -2022,9 +2022,11 @@ without repetition:
 example(zstyle ':completion:*' matcher-list '' '+m:{a-z}={A-Z}' '+m:{A-Z}={a-z}')
 
 It is possible to create match specifications valid for particular
-completers by using the third field of the context.  For example, to
-use the completers tt(_complete) and tt(_prefix) but only allow
-case-insensitive completion with tt(_complete):
+completers by using the third field of the context.  This applies only
+to completers that override the global matcher-list, which as of this
+writing includes only tt(_prefix) and tt(_ignored).  For example, to
+use the completers tt(_complete) and tt(_prefix) but allow
+case-insensitive completion only with tt(_complete):
 
 example(zstyle ':completion:*' completer _complete _prefix
 zstyle ':completion:*:complete:*' matcher-list \