; Add some tree-sitter thing content to the manual

* doc/lispref/parsing.texi (User-defined Things): List "builtin"
things.
This commit is contained in:
Yuan Fu 2024-12-15 21:40:49 -08:00
parent 55303a6bc0
commit 10f976300d
No known key found for this signature in database
GPG key ID: 56E19BC57664A442

View file

@ -1590,6 +1590,16 @@ Note that this example is modified for didactic purposes, and isn't
exactly how C and C@t{++} modes define things.
@end defvar
Emacs builtin functions already make use some thing definitions.
Command @code{treesit-forward-sexp} uses the @code{sexp} definition if
major mode defines it; @code{treesit-forward-sentence} uses the
@code{sentence} definition. Defun movement functions like
@code{treesit-end-of-defun} uses the @code{defun} definition
(@code{defun} definition is overridden by
@var{treesit-defun-type-regexp} for backward compatibility). Major
modes can also define @code{comment}, @code{string}, @code{text}
(generally comments and strings).
The rest of this section lists a few functions that take advantage of
the thing definitions. Besides the functions below, some other
functions listed elsewhere also utilize the thing feature, e.g.,