From 4a53d11e494876e9d2e91679816a868744fe8490 Mon Sep 17 00:00:00 2001
From: Maxime Coste <frrrwww@gmail.com>
Date: Tue, 3 Dec 2013 22:20:33 +0000
Subject: [PATCH] README: document shared highlighters

---
 README.asciidoc | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.asciidoc b/README.asciidoc
index 2f14e382..7d79346b 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -508,6 +508,27 @@ existing highlighters are:
        given flag in it for everly lines contained in the int-list option named
        <option_name>.
 
+Shared Highlighters
+~~~~~~~~~~~~~~~~~~~
+
+Highlighters are often defined for a specific filetype, and it makes then sense to
+share the highlighters between all the windows on the same filetypes.
+
+A shared highlighter can be defined with
+
+-----------------------
+defhl <shared_hl_name>
+-----------------------
+
+Highlighters can be added to it using the regular +:addhl+ command, with the
++-def-group <shared_hl_name>+ option.
+
+It can then be referenced in a window using the +ref+ highlighter.
+
+--------------------------
+addhl ref <shared_hl_name>
+--------------------------
+
 Hooks
 -----