about summary refs log tree commit diff
path: root/Doc/Zsh
diff options
context:
space:
mode:
authorDaniel Shahaf <d.s@daniel.shahaf.name>2015-09-07 21:17:35 +0000
committerDaniel Shahaf <d.s@daniel.shahaf.name>2015-09-07 21:17:40 +0000
commit8931e47b8d8f9194cc5424bc15e546c037a891e7 (patch)
tree48d45c6a9071525745b66c3dfbb65b86515dd26f /Doc/Zsh
parent1cba80bf08dc9451e8643588fcb308030bb4c4ee (diff)
downloadzsh-8931e47b8d8f9194cc5424bc15e546c037a891e7.tar.gz
zsh-8931e47b8d8f9194cc5424bc15e546c037a891e7.tar.xz
zsh-8931e47b8d8f9194cc5424bc15e546c037a891e7.zip
36437: Document interaction of $region_highlight and $zle_highlight.
Diffstat (limited to 'Doc/Zsh')
-rw-r--r--Doc/Zsh/zle.yo11
1 files changed, 11 insertions, 0 deletions
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index f450344ba..0613697a0 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -955,6 +955,11 @@ any predisplay string should be highlighted in bold.
 
 Note that the effect of tt(region_highlight) is not saved and disappears
 as soon as the line is accepted.
+
+The final highlighting on the command line depends on both tt(region_highlight)
+and tt(zle_highlight); see
+ifzman(the section CHARACTER HIGHLIGHTING below)\
+ifnzman(noderef(Character Highlighting)) for details.
 )
 vindex(UNDO_CHANGE_NO)
 item(tt(UNDO_CHANGE_NO) (integer))(
@@ -2521,6 +2526,12 @@ Following a command to paste text, the characters that were inserted.
 )
 enditem()
 
+When tt(region_highlight) is set, the contexts that describe a region DASH()-
+tt(isearch), tt(region), tt(suffix), and tt(paste) DASH()-
+are applied first, then tt(region_highlight) is applied, then the remaining
+tt(zle_highlight) contexts are applied.  If a particular character is
+affected by multiple specifications, the last specification wins.
+
 tt(zle_highlight) may contain additional fields for controlling how
 terminal sequences to change colours are output.  Each of the following is
 followed by a colon and a string in the same form as for key bindings.