; Explain the BEG and END argument in treesit-query-capture better

* doc/lispref/parsing.texi (Pattern Matching): Update manual.
* src/treesit.c (Ftreesit_query_capture): Update docstring.

diff --git a/doc/lispref/parsing.texi b/doc/lispref/parsing.texi
index 524b81a2bbd5353cf75aa53400afbbc454927dbd..7164baaa6d2c2046d70229856c9af9912fd11cb7 100644 (file)
--- a/doc/lispref/parsing.texi
+++ b/doc/lispref/parsing.texi
@@ -992,7 +992,9 @@ The function returns all the captured nodes in a list of the form
 non-@code{nil}, it returns the list of nodes instead.  By default the
 entire text of @var{node} is searched, but if @var{beg} and @var{end}
 are both non-@code{nil}, they specify the region of buffer text where
-this function should match nodes.
+this function should match nodes.  Any matching node whose span
+overlaps with the region between @var{beg} and @var{end} are captured,
+it doesn't have to be completely in the region.
 
 @vindex treesit-query-error
 @findex treesit-query-validate

diff --git a/src/treesit.c b/src/treesit.c
index e4be065d94ac4abb5ba74b775fd8c314d404dee0..9324b8b1006bb23caec8c4bbe36321a4392e1288 100644 (file)
--- a/src/treesit.c
+++ b/src/treesit.c
@@ -2178,8 +2178,10 @@ either string or sexp form.  When using repeatedly, a compiled query
 is much faster than a string or sexp one, so it is recommend to
 compile your query if it will be used repeatedly.
 
-BEG and END, if both non-nil, specify the region  of buffer positions
-in which the query is executed.
+BEG and END, if both non-nil, specify the region of buffer positions
+in which the query is executed.  Any matching node whose span overlaps
+with the region between BEG and END are captured, it doesn't have to
+be completely in the region.
 
 If NODE-ONLY is non-nil, return a list of nodes.