change context for i-c-w styles, update docs (12744)

2 files changed, 16 insertions, 4 deletions

diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index 37cff337d..c0b95b55d 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -96,7 +96,7 @@ works only if the names stored in the wordcode files are full paths or are
 relative to the directory that contains the wordcode file.
 
 In the first form, each var(name) is the name of a wordcode file or a
-directori containing wordcode files that should be checked. If no
+directory containing wordcode files that should be checked. If no
 arguments are given, the directories and wordcode files in $fpath are
 used.
 
@@ -432,7 +432,9 @@ item(tt(break-keys))(
 This style is used by the tt(incremental-complete-word) widget. Its value
 should be a pattern, and all keys matching this pattern will cause the
 widget to stop incremental completion without the key having any further
-effect.
+effect. Like all styles used directly by
+tt(incremental-complete-word), this style is looked up using the
+context `tt(:incremental)'.
 )
 kindex(completer, completion style)
 item(tt(completer))(
@@ -519,11 +521,14 @@ Replaced by the unambiguous part of all matches, if there
 is any, and if it is different from the word on the line.
 )
 enditem()
+
+Like `tt(break-keys)', this uses the `tt(:incremental)' context.
 )
 kindex(stop-keys, completion style)
 item(tt(stop-keys))(
 This style is used by the tt(incremental-complete-word) widget.  Its value
-is treated similarly to the one for the tt(break-keys) style.  However, in
+is treated similarly to the one for the tt(break-keys) style (and uses 
+the same context: `tt(:incremental)').  However, in
 this case all keys matching the pattern given as its value will stop
 incremental completion and will then execute their usual function.
 )
diff --git a/Doc/Zsh/mod_complist.yo b/Doc/Zsh/mod_complist.yo
index ba5416d4f..cc2b22ce8 100644
--- a/Doc/Zsh/mod_complist.yo
+++ b/Doc/Zsh/mod_complist.yo
@@ -118,7 +118,14 @@ tt(no), and tt(rc) if tt(ec) is not defined.
 
 The default values are ISO 6429 (ANSI) compliant and can be used on
 vt100 compatible terminals such as tt(xterm)s.  On monochrome terminals
-the default values will have no visible effect.
+the default values will have no visible effect.  The tt(colors)
+function from the contribution can be used to get associative arrays
+containing the codes for ANSI terminals (see
+ifzman(the section `Other Functions' in zmanref(zshcontrib))\
+ifnzman(noderef(Other Functions))\
+).  For example, after loading tt(colors), one could use
+`tt($colors[red])' to get the code for foreground color red and
+`tt($colors[bg-green])' for the code for background color green.
 
 If the completion system based around shell functions is used, these
 parameters should not be set directly because the system controls them