mirrors/neovim
1
0
Fork 0
mirror of https://github.com/neovim/neovim.git synced 2025-09-07 11:58:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(treesitter): use full function names in tags (#21321)

Browse Source
This commit is contained in:
Gregory Anders
2022-12-07 01:27:41 -07:00
committed by GitHub
parent 0caae2376e
commit f8aa2a0dea
2 changed files with 48 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files

77
runtime/doc/treesitter.txt
View File

@@ -56,11 +56,11 @@ current state of the buffer. When the plugin wants to access the state after a
the same tree will be returned again without extra work. If the buffer was the same tree will be returned again without extra work. If the buffer was
parsed before, incremental parsing will be done of the changed parts. parsed before, incremental parsing will be done of the changed parts.
Note: To use the parser directly inside a |nvim_buf_attach()| Lua callback, you Note: To use the parser directly inside a |nvim_buf_attach()| Lua callback,
must call |get_parser()| before you register your callback. But preferably you must call |vim.treesitter.get_parser()| before you register your callback.
parsing shouldn't be done directly in the change callback anyway as they will But preferably parsing shouldn't be done directly in the change callback
be very frequent. Rather a plugin that does any kind of analysis on a tree anyway as they will be very frequent. Rather a plugin that does any kind of
should use a timer to throttle too frequent updates. analysis on a tree should use a timer to throttle too frequent updates.
See |lua-treesitter-languagetree| for the list of available methods. See |lua-treesitter-languagetree| for the list of available methods.
@@ -253,8 +253,8 @@ The following predicates are built in:
Each predicate has a `not-` prefixed predicate that is just the negation of Each predicate has a `not-` prefixed predicate that is just the negation of
the predicate. the predicate.
Further predicates can be added via `vim.treesitter.query.`|add_predicate()|. Further predicates can be added via |vim.treesitter.query.add_predicate()|.
Use `vim.treesitter.query.`|list_predicates()| to list all available Use |vim.treesitter.query.list_predicates()| to list all available
predicates. predicates.
@@ -297,8 +297,8 @@ The following directives are built in:
((identifier) @constant (#offset! @constant 0 1 0 -1)) ((identifier) @constant (#offset! @constant 0 1 0 -1))
< <
Further directives can be added via `vim.treesitter.query.`|add_directive()|. Further directives can be added via |vim.treesitter.query.add_directive()|.
Use `vim.treesitter.query.`|list_directives()| to list all available Use |vim.treesitter.query.list_directives()| to list all available
directives. directives.
@@ -481,7 +481,8 @@ library.
============================================================================== ==============================================================================
Lua module: vim.treesitter *lua-treesitter-core* Lua module: vim.treesitter *lua-treesitter-core*
get_captures_at_cursor({winnr}) *get_captures_at_cursor()* *vim.treesitter.get_captures_at_cursor()*
get_captures_at_cursor({winnr})
Returns a list of highlight capture names under the cursor Returns a list of highlight capture names under the cursor
Parameters: ~ Parameters: ~
@@ -490,7 +491,8 @@ get_captures_at_cursor({winnr}) *get_captures_at_cursor()*
Return: ~ Return: ~
string[] List of capture names string[] List of capture names
get_captures_at_pos({bufnr}, {row}, {col}) *get_captures_at_pos()* *vim.treesitter.get_captures_at_pos()*
get_captures_at_pos({bufnr}, {row}, {col})
Returns a list of highlight captures at the given position Returns a list of highlight captures at the given position
Each capture is represented by a table containing the capture name as a Each capture is represented by a table containing the capture name as a
@@ -506,7 +508,7 @@ get_captures_at_pos({bufnr}, {row}, {col}) *get_captures_at_pos()*
table[] List of captures `{ capture = "capture name", metadata = { ... table[] List of captures `{ capture = "capture name", metadata = { ...
} }` } }`
get_node_at_cursor({winnr}) *get_node_at_cursor()* get_node_at_cursor({winnr}) *vim.treesitter.get_node_at_cursor()*
Returns the smallest named node under the cursor Returns the smallest named node under the cursor
Parameters: ~ Parameters: ~
@@ -515,7 +517,8 @@ get_node_at_cursor({winnr}) *get_node_at_cursor()*
Return: ~ Return: ~
(string) Name of node under the cursor (string) Name of node under the cursor
get_node_at_pos({bufnr}, {row}, {col}, {opts}) *get_node_at_pos()* *vim.treesitter.get_node_at_pos()*
get_node_at_pos({bufnr}, {row}, {col}, {opts})
Returns the smallest named node at the given position Returns the smallest named node at the given position
Parameters: ~ Parameters: ~
@@ -529,7 +532,7 @@ get_node_at_pos({bufnr}, {row}, {col}, {opts}) *get_node_at_pos()*
Return: ~ Return: ~
userdata |tsnode| under the cursor userdata |tsnode| under the cursor
get_node_range({node_or_range}) *get_node_range()* get_node_range({node_or_range}) *vim.treesitter.get_node_range()*
Returns the node's range or an unpacked range table Returns the node's range or an unpacked range table
Parameters: ~ Parameters: ~
@@ -538,7 +541,7 @@ get_node_range({node_or_range}) *get_node_range()*
Return: ~ Return: ~
(table) `{ start_row, start_col, end_row, end_col }` (table) `{ start_row, start_col, end_row, end_col }`
get_parser({bufnr}, {lang}, {opts}) *get_parser()* get_parser({bufnr}, {lang}, {opts}) *vim.treesitter.get_parser()*
Returns the parser for a specific buffer and filetype and attaches it to Returns the parser for a specific buffer and filetype and attaches it to
the buffer the buffer
@@ -554,7 +557,8 @@ get_parser({bufnr}, {lang}, {opts}) *get_parser()*
Return: ~ Return: ~
LanguageTree |LanguageTree| object to use for parsing LanguageTree |LanguageTree| object to use for parsing
get_string_parser({str}, {lang}, {opts}) *get_string_parser()* *vim.treesitter.get_string_parser()*
get_string_parser({str}, {lang}, {opts})
Returns a string parser Returns a string parser
Parameters: ~ Parameters: ~
@@ -565,7 +569,7 @@ get_string_parser({str}, {lang}, {opts}) *get_string_parser()*
Return: ~ Return: ~
LanguageTree |LanguageTree| object to use for parsing LanguageTree |LanguageTree| object to use for parsing
is_ancestor({dest}, {source}) *is_ancestor()* is_ancestor({dest}, {source}) *vim.treesitter.is_ancestor()*
Determines whether a node is the ancestor of another Determines whether a node is the ancestor of another
Parameters: ~ Parameters: ~
@@ -575,7 +579,8 @@ is_ancestor({dest}, {source}) *is_ancestor()*
Return: ~ Return: ~
(boolean) True if {dest} is an ancestor of {source} (boolean) True if {dest} is an ancestor of {source}
is_in_node_range({node}, {line}, {col}) *is_in_node_range()* *vim.treesitter.is_in_node_range()*
is_in_node_range({node}, {line}, {col})
Determines whether (line, col) position is in node range Determines whether (line, col) position is in node range
Parameters: ~ Parameters: ~
@@ -586,7 +591,7 @@ is_in_node_range({node}, {line}, {col}) *is_in_node_range()*
Return: ~ Return: ~
(boolean) True if the position is in node range (boolean) True if the position is in node range
node_contains({node}, {range}) *node_contains()* node_contains({node}, {range}) *vim.treesitter.node_contains()*
Determines if a node contains a range Determines if a node contains a range
Parameters: ~ Parameters: ~
@@ -596,7 +601,7 @@ node_contains({node}, {range}) *node_contains()*
Return: ~ Return: ~
(boolean) True if the {node} contains the {range} (boolean) True if the {node} contains the {range}
start({bufnr}, {lang}) *start()* start({bufnr}, {lang}) *vim.treesitter.start()*
Starts treesitter highlighting for a buffer Starts treesitter highlighting for a buffer
Can be used in an ftplugin or FileType autocommand. Can be used in an ftplugin or FileType autocommand.
@@ -621,7 +626,7 @@ start({bufnr}, {lang}) *start()*
• {lang} (string|nil) Language of the parser (default: buffer • {lang} (string|nil) Language of the parser (default: buffer
filetype) filetype)
stop({bufnr}) *stop()* stop({bufnr}) *vim.treesitter.stop()*
Stops treesitter highlighting for a buffer Stops treesitter highlighting for a buffer
Parameters: ~ Parameters: ~
@@ -632,7 +637,7 @@ stop({bufnr}) *stop()*
============================================================================== ==============================================================================
Lua module: vim.treesitter.language *lua-treesitter-language* Lua module: vim.treesitter.language *lua-treesitter-language*
inspect_language({lang}) *inspect_language()* inspect_language({lang}) *vim.treesitter.language.inspect_language()*
Inspects the provided language. Inspects the provided language.
Inspecting provides some useful information on the language like node Inspecting provides some useful information on the language like node
@@ -644,7 +649,7 @@ inspect_language({lang}) *inspect_language()*
Return: ~ Return: ~
(table) (table)
*require_language()* *vim.treesitter.language.require_language()*
require_language({lang}, {path}, {silent}, {symbol_name}) require_language({lang}, {path}, {silent}, {symbol_name})
Asserts that a parser for the language {lang} is installed. Asserts that a parser for the language {lang} is installed.
@@ -666,7 +671,8 @@ require_language({lang}, {path}, {silent}, {symbol_name})
============================================================================== ==============================================================================
Lua module: vim.treesitter.query *lua-treesitter-query* Lua module: vim.treesitter.query *lua-treesitter-query*
add_directive({name}, {handler}, {force}) *add_directive()* *vim.treesitter.query.add_directive()*
add_directive({name}, {handler}, {force})
Adds a new directive to be used in queries Adds a new directive to be used in queries
Handlers can set match level data by setting directly on the metadata Handlers can set match level data by setting directly on the metadata
@@ -679,7 +685,8 @@ add_directive({name}, {handler}, {force}) *add_directive()*
• {handler} function(match:string, pattern:string, bufnr:number, • {handler} function(match:string, pattern:string, bufnr:number,
predicate:function, metadata:table) predicate:function, metadata:table)
add_predicate({name}, {handler}, {force}) *add_predicate()* *vim.treesitter.query.add_predicate()*
add_predicate({name}, {handler}, {force})
Adds a new predicate to be used in queries Adds a new predicate to be used in queries
Parameters: ~ Parameters: ~
@@ -687,7 +694,8 @@ add_predicate({name}, {handler}, {force}) *add_predicate()*
• {handler} function(match:string, pattern:string, bufnr:number, • {handler} function(match:string, pattern:string, bufnr:number,
predicate:function) predicate:function)
get_node_text({node}, {source}, {opts}) *get_node_text()* *vim.treesitter.query.get_node_text()*
get_node_text({node}, {source}, {opts})
Gets the text corresponding to a given node Gets the text corresponding to a given node
Parameters: ~ Parameters: ~
@@ -701,7 +709,7 @@ get_node_text({node}, {source}, {opts}) *get_node_text()*
Return: ~ Return: ~
(string[]|string) (string[]|string)
get_query({lang}, {query_name}) *get_query()* get_query({lang}, {query_name}) *vim.treesitter.query.get_query()*
Returns the runtime query {query_name} for {lang}. Returns the runtime query {query_name} for {lang}.
Parameters: ~ Parameters: ~
@@ -711,7 +719,7 @@ get_query({lang}, {query_name}) *get_query()*
Return: ~ Return: ~
Query Parsed query Query Parsed query
*get_query_files()* *vim.treesitter.query.get_query_files()*
get_query_files({lang}, {query_name}, {is_included}) get_query_files({lang}, {query_name}, {is_included})
Gets the list of files used to make up a query Gets the list of files used to make up a query
@@ -725,19 +733,19 @@ get_query_files({lang}, {query_name}, {is_included})
string[] query_files List of files to load for given query and string[] query_files List of files to load for given query and
language language
list_directives() *list_directives()* list_directives() *vim.treesitter.query.list_directives()*
Lists the currently available directives to use in queries. Lists the currently available directives to use in queries.
Return: ~ Return: ~
string[] List of supported directives. string[] List of supported directives.
list_predicates() *list_predicates()* list_predicates() *vim.treesitter.query.list_predicates()*
Lists the currently available predicates to use in queries. Lists the currently available predicates to use in queries.
Return: ~ Return: ~
string[] List of supported predicates. string[] List of supported predicates.
parse_query({lang}, {query}) *parse_query()* parse_query({lang}, {query}) *vim.treesitter.query.parse_query()*
Parse {query} as a string. (If the query is in a file, the caller should Parse {query} as a string. (If the query is in a file, the caller should
read the contents into a string before calling). read the contents into a string before calling).
@@ -828,7 +836,8 @@ Query:iter_matches({self}, {node}, {source}, {start}, {stop})
(table) match (table) match
(table) metadata (table) metadata
set_query({lang}, {query_name}, {text}) *set_query()* *vim.treesitter.query.set_query()*
set_query({lang}, {query_name}, {text})
Sets the runtime query named {query_name} for {lang} Sets the runtime query named {query_name} for {lang}
This allows users to override any runtime files and/or configuration set This allows users to override any runtime files and/or configuration set
@@ -843,7 +852,7 @@ set_query({lang}, {query_name}, {text}) *set_query()*
============================================================================== ==============================================================================
Lua module: vim.treesitter.highlighter *lua-treesitter-highlighter* Lua module: vim.treesitter.highlighter *lua-treesitter-highlighter*
new({tree}, {opts}) *highlighter.new()* new({tree}, {opts}) *vim.treesitter.highlighter.new()*
Creates a new highlighter using Creates a new highlighter using
Parameters: ~ Parameters: ~
@@ -1014,7 +1023,7 @@ LanguageTree:trees({self}) *LanguageTree:trees()*
Parameters: ~ Parameters: ~
• {self} • {self}
new({source}, {lang}, {opts}) *languagetree.new()* new({source}, {lang}, {opts}) *vim.treesitter.languagetree.new()*
A |LanguageTree| holds the treesitter parser for a given language {lang} A |LanguageTree| holds the treesitter parser for a given language {lang}
used to parse a buffer. As the buffer may contain injected languages, the LanguageTree needs to store parsers for these child languages as well (which in turn used to parse a buffer. As the buffer may contain injected languages, the LanguageTree needs to store parsers for these child languages as well (which in turn
may contain child languages themselves, hence the name). may contain child languages themselves, hence the name).

16
scripts/gen_vimdoc.py
View File

@@ -258,17 +258,11 @@ CONFIG = {
if name.lower() == 'treesitter' if name.lower() == 'treesitter'
else f'*lua-treesitter-{name.lower()}*'), else f'*lua-treesitter-{name.lower()}*'),
'fn_helptag_fmt': lambda fstem, name: ( 'fn_helptag_fmt': lambda fstem, name: (
f'*{name}()*' f'*vim.{fstem}.{name}()*'
if name != 'new' if fstem == 'treesitter'
else f'*{fstem}.{name}()*'), else f'*{name}()*'
# 'fn_helptag_fmt': lambda fstem, name: ( if name[0].isupper()
# f'*vim.treesitter.{name}()*' else f'*vim.treesitter.{fstem}.{name}()*'),
# if fstem == 'treesitter'
# else (
# '*vim.lsp.client*'
# # HACK. TODO(justinmk): class/structure support in lua2dox
# if 'lsp.client' == f'{fstem}.{name}'
# else f'*vim.lsp.{fstem}.{name}()*')),
'module_override': {}, 'module_override': {},
'append_only': [], 'append_only': [],
} }