diff options
| author | Björn Linse <bjorn.linse@gmail.com> | 2021-07-23 17:56:16 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-07-23 17:56:16 +0200 |
| commit | 754ac5a834cb82f73ca552a9a55b90a40f9367f6 (patch) | |
| tree | defa4a691604ca45742399336bc91e32175785d1 /runtime/doc | |
| parent | a8c3d50fad94971ebfe9eeedf933bdd829e66787 (diff) | |
| parent | 5ea6cc1d752bff196711f58d36b541e660fdcc1a (diff) | |
| download | rneovim-754ac5a834cb82f73ca552a9a55b90a40f9367f6.tar.gz rneovim-754ac5a834cb82f73ca552a9a55b90a40f9367f6.tar.bz2 rneovim-754ac5a834cb82f73ca552a9a55b90a40f9367f6.zip | |
Merge pull request #15114 from theHamsta/treesitter-hl-priority
feat(treesitter): allow to set highlight priority for queries
Diffstat (limited to 'runtime/doc')
| -rw-r--r-- | runtime/doc/api.txt | 5 | ||||
| -rw-r--r-- | runtime/doc/treesitter.txt | 13 |
2 files changed, 16 insertions, 2 deletions
diff --git a/runtime/doc/api.txt b/runtime/doc/api.txt index 4dcf5b7bbc..9b8259c2fb 100644 --- a/runtime/doc/api.txt +++ b/runtime/doc/api.txt @@ -2334,8 +2334,9 @@ nvim_buf_set_extmark({buffer}, {ns_id}, {line}, {col}, {opts}) inserted (true for right, false for left). Defaults to false. • priority: a priority value for the highlight - group. For example treesitter highlighting - uses a value of 100. + group. Default: 4096. For example, treesitter + highlighting uses a default value of 100 (see + |lua-treesitter-highlight-priority|). Return: ~ Id of the created/updated extmark diff --git a/runtime/doc/treesitter.txt b/runtime/doc/treesitter.txt index 416ea3a08a..340db92ae3 100644 --- a/runtime/doc/treesitter.txt +++ b/runtime/doc/treesitter.txt @@ -294,6 +294,19 @@ identical identifiers, highlighting both as |hl-WarningMsg|: > ((binary_expression left: (identifier) @WarningMsg.left right: (identifier) @WarningMsg.right) (eq? @WarningMsg.left @WarningMsg.right)) < +Treesitter Highlighting Priority *lua-treesitter-highlight-priority* + +Tree-sitter uses |nvim_buf_set_extmark()| to set highlights with a default +priority of 100. This enables plugins to set a highlighting priority lower or +higher than tree-sitter. It is also possible to change the priority of an +individual query pattern manually by setting its `"priority"` metadata attribute: > + + ( + (super_important_node) @ImportantHighlight + ; Give the whole query highlight priority higher than the default (100) + (set! "priority" 105) + ) +< ============================================================================== Lua module: vim.treesitter *lua-treesitter-core* |