aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorYuan Fu2023-01-02 14:15:36 -0800
committerYuan Fu2023-01-02 14:25:54 -0800
commitaef869e74f47bbe00c8cf0cb02cea20aa0c33a6d (patch)
tree2db5efb43879cb82c4e2d16f3a1e5b9e163acfa6
parent4ef12cfb1fc3f08fc17f0ed622ddfcb1d26cefc8 (diff)
downloademacs-aef869e74f47bbe00c8cf0cb02cea20aa0c33a6d.tar.gz
emacs-aef869e74f47bbe00c8cf0cb02cea20aa0c33a6d.zip
; Update tree-sitter manual
* doc/lispref/positions.texi (List Motion): Replace treesit-defun-prefer-top-level with treesit-defun-tactic.
-rw-r--r--doc/lispref/positions.texi23
1 files changed, 6 insertions, 17 deletions
diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi
index 68e948bacd8..f47720184a3 100644
--- a/doc/lispref/positions.texi
+++ b/doc/lispref/positions.texi
@@ -848,25 +848,14 @@ The value of this variable is a regexp matching the node type of defun
848nodes. (For ``node'' and ``node type'', @pxref{Parsing Program Source}.) 848nodes. (For ``node'' and ``node type'', @pxref{Parsing Program Source}.)
849 849
850For example, @code{python-mode} sets this variable to a regexp that 850For example, @code{python-mode} sets this variable to a regexp that
851matches either @code{function_definition} or @code{class_definition}. 851matches either @code{"function_definition"} or @code{"class_definition"}.
852@end defvar 852@end defvar
853 853
854@defvar treesit-defun-prefer-top-level 854@defvar treesit-defun-tactic
855If this variable is non-@code{nil}, Emacs skips nested defuns, when it 855This variable determines how does Emacs treat nested defuns. If the
856looks for beginning and end of a defun, and prefers to go to the 856value is @code{top-level}, navigation functions only move across
857top-level defun instead. 857top-level defuns, if the value is @code{nested}, navigation functions
858 858recognize nested defuns.
859In some languages, a defun could be nested in another one. By default,
860Emacs stops at the first defun it encounters. But if this variable's
861value is @code{t}, whenever Emacs finds a defun node, it tries to go
862up the parse tree until it finds the top-level defun.
863
864This variable can also be a list of cons cells of the form
865@w{@code{(@var{from} . @var{to}))}}, where @var{from} and @var{to} are
866regexps matching tree-sitter node types. When Emacs finds a defun
867node whose type matches any of the @var{from} regexps in the list, it
868then tries to go up the parse tree until it finds a higher-level node
869matching the corresponding @var{to} regexp.
870@end defvar 859@end defvar
871 860
872@node Skipping Characters 861@node Skipping Characters