README

June 28, 2025 · View on GitHub

Hier hier

============================================================================== DESCRIPTION hier-description

Highlight quickfix errors and location list entries in buffer. This plugin was designed to support the editqf vim script (http://www.vim.org/scripts/script.php?script_id=3557) but it also works very well stand alone.

This script can be downloaded from http://www.vim.org/scripts/script.php?script_id=3564. The latest development version is available at https://github.com/jceb/vim-hier.

============================================================================== USAGE hier-usage

The following commands are provided: :HierStart " enable hier highlighting :HierStop " disable hier highlighting :HierUpdate " update error highlighting for current buffer :HierClear " remove highlighting - it will be displayed " again when :HierUpdate is called

============================================================================== CUSTOMIZATION hier-customization

The highlight group can be customized by setting the following variables. Setting a variable to the string "" will disable highlighting of that group. Every type can be highlighted differently (error, warning, info): let g:hier_highlight_group_qf = 'SpellBad' let g:hier_highlight_group_qfw = 'SpellLocal' let g:hier_highlight_group_qfi = 'SpellRare'

let g:hier_highlight_group_loc  = 'SpellBad'
let g:hier_highlight_group_locw = 'SpellLocal'
let g:hier_highlight_group_loci = 'SpellRare'

Enable/disable highlighting highlighting by default: let g:hier_enabled = 1

For inner lines (all but the first and last one) of mutliline matches the maximum length of the highlight can be set. Defaults to 10000 (the whole line for every reasonable line of code) but a value between 2 and 5 is nice to outline the range of the issue while keeping the code readable. let g:hier_multiline_inner_length = 10000

============================================================================== INSTALLATION hier-installation

Download hier.vba.gz
Open file in vim and run :so % to install plugin
Restart vim

============================================================================== RELATED PLUGINS hier-related

editqf is a plugin that let's you edit and add entries in quickfix window. The hier plugin is a useful extension to the editqf plugin (http://www.vim.org/scripts/script.php?script_id=3557)
quickfixsigns is a plugin similar to hier. The main difference is that it highlights the quickfix locations in a separate column. quickfixsigns also support the highlighting of marks which is not in the focus of hier. (http://www.vim.org/scripts/script.php?script_id=2584)

============================================================================== CHANGLOG hier-changelog

1.3

fix problem when disabling the highlighting by setting the hier_highlight_group variables to the empty string ""

1.2

add highlighting groups for warning and info entries
make clearing of highlighting behave more graceful towards other plugins
add function s:Getlist to remove duplicated code

1.1

add commands :HierStart and :HierStop
add support for highlighting location list entries
add support for highlighting pattern entries

1.0

inital release

vim:tw=78:ts=8:ft=help:norl: