From: Yuan Fu <casouri@gmail.com>
Date: Mon, 16 Dec 2024 05:40:49 +0000 (-0800)
Subject: ; Add some tree-sitter thing content to the manual
X-Git-Tag: archive/raspbian/1%30.1+1-3+rpi1^2~2^2~20^2~193
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=10f976300d03a8cb9a12a5d2548d1b275ac3edcc;p=emacs.git

; Add some tree-sitter thing content to the manual

* doc/lispref/parsing.texi (User-defined Things): List "builtin"
things.
---

diff --git a/doc/lispref/parsing.texi b/doc/lispref/parsing.texi
index f8bf0b20a7c..fbecbc69276 100644
--- a/doc/lispref/parsing.texi
+++ b/doc/lispref/parsing.texi
@@ -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.,