Fine grained statusline and better documentation

autoload/highlight.vim

@@ -85,10 +85,11 @@ endfunction
 " FUNCTION: Statusline() {{{1
 " ==============================================================================
 " Allow for integrating the currently highlighted section into the statusline.
+" Mirrors the look of a given prompted highlight group (e.g. :hi Search)
 
-function! highlight#statusline(...)
+function! highlight#statusline()
-  let l:group_name = highlight#get_group_name(s:active_register)
+  let l:stl = '\' . s:active_register
-  return '%#' . l:group_name . '#xxx (" . s:active_register . ")%*'
+  return l:stl . l:stl . l:stl
 endfunction
 
 

doc/highlight.txt

@@ -59,6 +59,11 @@ highlight#statusline()
 
                 :set statusline+=%{highlight#statusline()}
 
+    If you would like the statusline to be highlighted the same as the active
+    h_register, use:
+
+            :set statusline+=%#Search#%{highlight#statusline()}%*
+
 ==============================================================================
 Section 3: Commands                                       *highlight-commands*
 

doc/tags

@@ -1,5 +0,0 @@
-highlight-commands	highlight.txt	/*highlight-commands*
-highlight-contents	highlight.txt	/*highlight-contents*
-highlight-registry	highlight.txt	/*highlight-registry*
-highlight-statusline	highlight.txt	/*highlight-statusline*
-highlight-usage	highlight.txt	/*highlight-usage*