treesitter: add some documentation for parsers

This commit is contained in:
Thomas Vigouroux 2020-06-14 19:14:52 +02:00
parent 75a1239eb5
commit 558893b1b9
1 changed files with 13 additions and 0 deletions

View File

@ -512,6 +512,9 @@ retained for the lifetime of a buffer but this is subject to change. A plugin
should keep a reference to the parser object as long as it wants incremental
updates.
Parser methods *lua-treesitter-parser*
tsparser:parse() *tsparser:parse()*
Whenever you need to access the current syntax tree, parse the buffer: >
tstree = parser:parse()
@ -528,6 +531,16 @@ shouldn't be done directly in the change callback anyway as they will be very
frequent. Rather a plugin that does any kind of analysis on a tree should use
a timer to throttle too frequent updates.
tsparser:set_included_ranges(ranges) *tsparser:set_included_ranges()*
Changes the ranges the parser should consider. This is used for
language injection. `ranges` should be of the form (all zero-based): >
{
{start_node, end_node},
...
}
<
NOTE: `start_node` and `end_node` are both inclusive.
Tree methods *lua-treesitter-tree*
tstree:root() *tstree:root()*