Merge pull request #6700 from bfredl/winhl

window specific ui highlighting: part 2

1 files changed, 10 insertions, 3 deletions

diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 2097cbf32b..bb5cfb4a80 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -6778,9 +6778,16 @@ A jump table for the options with a short description can be found at |Q_op|.
 	Window-local highlights.  Comma-delimited list of |group-name| pairs
 	"{hl-builtin}:{hl-group},..." where each {hl-builtin} is a group (from
 	|highlight-groups|) to be overridden by {hl-group} in the window where
-	this option was set.
-	Currently |hl-Normal| and |hl-NormalNC| can be overridden.
-	Useful for changing the background color. Example: >
+	this option was set.  Only builting ui highlights are supported, not
+	syntax highlighting.  For that purpose, use |:ownsyntax|.
+	
+	Most highlights occuring within the frame of a window are supported.
+	Highlights of vertical separators are determined by the window to the
+	left of the separator.  The highlight of a tabpage in |tabline| is
+	determined by the last focused window in the tabpage.  Highlights of
+	the popupmenu are determined by the current window.  Highlights in the
+	message area are not overridable.  Example for overriding the
+	backgrond color: >
 		set winhighlight=Normal:MyNormal,NormalNC:MyNormalNC
 <
 			*'winfixheight'* *'wfh'* *'nowinfixheight'* *'nowfh'*