benbot/nvim-treesitter
1
0
Fork 0
mirror of https://github.com/nvim-treesitter/nvim-treesitter.git synced 2026-07-13 08:50:11 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Docs: update docs on how to override a query

Browse source 
`queries/` and `after/queries/` are the same now.
I kind of prefer the old method, but just updating our docs to reflect
the reality for now.

Closes https://github.com/nvim-treesitter/nvim-treesitter/issues/1710
Closes https://github.com/nvim-treesitter/nvim-treesitter/issues/1441
This commit is contained in:
Santos Gallegos 2021-11-13 15:33:07 -05:00
parent a47df48e7d
commit 9ee1de787a
1 changed files with 18 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

29
README.md
View file

@ -363,22 +363,29 @@ EOF
## Adding queries ## Adding queries
Queries are what `nvim-treesitter` uses to extract information from the syntax tree; they are Queries are what `nvim-treesitter` uses to extract information from the syntax tree;
located in the `queries/{language}/*` runtime directories (like the `queries` folder of this plugin), e.g., `queries/{language}/{locals,highlights,textobjects}.scm`. they are located in the `queries/{language}/*` runtime directories (see `:h rtp`),
like the `queries` folder of this plugin, e.g. `queries/{language}/{locals,highlights,textobjects}.scm`.
Other modules may require additional queries such as `folding.scm`. Other modules may require additional queries such as `folding.scm`.
`nvim-treesitter` considers queries as any runtime file (see `:h rtp`), i.e., All queries found in the runtime directories will be combined.
By convention, if you want to write a query, use the `queries/` directory,
but if you want to extend a query use the `after/queries/` directory.
- if the file is in any `after/queries/` folder, then it will be used to extend the already defined If you want to completely override a query, you can use `:h set_query()`.
queries. For example, to override the `injections` queries from `c` with your own:
- Otherwise, it will be used as a base to define the query, the first query found (with the highest
priority) will be the only one to be used.
This hybrid approach is the most standard way; in this case ```lua
-- On your init.lua
require("vim.treesitter.query").set_query("c", "injections", "(comment) @comment")
```
- if you want to rewrite (or write) a query, don't use `after/queries`; ```vim
- if you want to override a part of a query (only one match for example), use the `after/queries` " Or in your init.vim
directory. call v:lua.require("vim.treesitter.query").set_query("c", "injections", "(comment) @comment")
```
Note: when using `set_query`, all queries in the runtime directories will be ignored.
## Adding modules ## Adding modules