summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog5
-rw-r--r--Doc/Zsh/compsys.yo12
2 files changed, 11 insertions, 6 deletions
diff --git a/ChangeLog b/ChangeLog
index 91967edea..839e5af69 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,6 @@
+2014-03-03  Barton E. Schaefer  <schaefer@zsh.org>
+
+	* users/18550: Doc/Zsh/compsys.yo: matcher-list clarifications
 2014-03-03  Simon Ruderich  <simon@ruderich.org>
 
 	* 32289: Doc: Add zsh version to footer in HTML documentation.
@@ -124,7 +127,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 f015bbf92..8a9f47db1 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 \