; Fix documentation of recent treesit changes

* src/treesit.c (Ftreesit_query_capture)
(Ftreesit_parser_embed_level, Ftreesit_parser_set_embed_level)
(Ftreesit_parser_set_parent_node):
* lisp/treesit.el (treesit-query-range)
(treesit-query-range-by-language, treesit-range-settings)
(treesit-range-rules, treesit--parser-at-level)
(treesit--update-ranges-non-local, treesit--update-ranges-local)
(treesit--update-range-1): Fix wording and typos in doc strings.

* doc/lispref/parsing.texi (Pattern Matching): Fix wording.

2 files changed, 18 insertions, 14 deletions

diff --git a/src/treesit.c b/src/treesit.c
index c8af17a5b8b..20c3626732a 100644
--- a/src/treesit.c
+++ b/src/treesit.c
@@ -1827,8 +1827,8 @@ DEFUN ("treesit-parser-embed-level",
 
 The embed level can be either nil or a non-negative integer.  A value of
 nil means the parser isn't part of the embedded parser tree.  The
-primary parser has embed level 0, from it, each layer of embedded parser
-has +1 embed level.  */)
+primary parser has embed level 0, and each additional layer of parser
+embedding increments the embed level by 1.  */)
   (Lisp_Object parser)
 {
   treesit_check_parser (parser);
@@ -1839,7 +1839,9 @@ has +1 embed level.  */)
 DEFUN ("treesit-parser-set-embed-level",
        Ftreesit_parser_set_embed_level, Streesit_parser_set_embed_level,
        2, 2, 0,
-       doc: /* Set the embed level for PARSER to LEVEL.  */)
+       doc: /* Set the embed level for PARSER to LEVEL.
+LEVEL can be nil, for a parser that is not part of an embedded parser
+tree; otherwise it must be a non-negative integer.  */)
   (Lisp_Object parser, Lisp_Object level)
 {
   treesit_check_parser (parser);
@@ -1859,7 +1861,7 @@ DEFUN ("treesit-parser-parent-node",
        1, 1, 0,
        doc: /* Return PARSER's parent node, if one exists.
 
-Only embeded local parser can have parent node.  When Emacs uses a node
+Only embeded local parsers can have parent node.  When Emacs uses a node
 in the host parser to create this local parser, that node is considered
 the parent node of the local parser.  */)
   (Lisp_Object parser)
@@ -1871,7 +1873,7 @@ the parent node of the local parser.  */)
 DEFUN ("treesit-parser-set-parent-node",
        Ftreesit_parser_set_parent_node, Streesit_parser_set_parent_node,
        2, 2, 0,
-       doc: /* Return PARSER's parent node to NODE.  */)
+       doc: /* Make NODE be the parent node of PARSER.  */)
   (Lisp_Object parser, Lisp_Object node)
 {
   treesit_check_parser (parser);
@@ -3289,8 +3291,9 @@ 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 GROUPED is non-nil, group captures into matches and return a list of
-MATCH, where each MATH is a list of (CAPTURE_NAME . NODE).
+If GROUPED is non-nil, ther function groups the returned list of
+captures into matches and return a list of MATCH, where each MATCH is
+a list of the form (CAPTURE_NAME . NODE).
 
 If NODE-ONLY is non-nil, return nodes only, and don't include
 CAPTURE_NAME.
diff --git a/src/treesit.h b/src/treesit.h
index d19a0e76216..d4cfc47ee5d 100644
--- a/src/treesit.h
+++ b/src/treesit.h
@@ -64,12 +64,13 @@ struct Lisp_TS_Parser
      = 0, end_byte = UINT32_MAX).  */
   Lisp_Object last_set_ranges;
   /* Parsers for embedded code blocks will have a non-zero embed level.
-     The primary parser has level 0, and each layer of embedded parser
-     gets +1 level.  The embed level can be either a non-negative
-     integer or nil.  Every parser created by treesit-parser-create
-     starts with a nil level.  If the value is nil, that means the range
-     functions (treesit-update-ranges and friends) haven't touched this
-     parser yet, and this parser isn't part of the embed parser tree.  */
+     The primary parser has level 0, and each additional layer of parser
+     embedding increments the leve by 1.  The embed level can be either
+     a non-negative integer or nil.  Every parser created by
+     'treesit-parser-create' starts with a nil level.  If the value is
+     nil, that means the range functions (treesit-update-ranges and
+     friends) haven't touched this parser yet, and this parser isn't
+     part of the embed parser tree.  */
   Lisp_Object embed_level;
   /* Some comments: Technically you could calculate embed_level by
      following parent_node, but parent_node might be outdated so it's a
@@ -80,7 +81,7 @@ struct Lisp_TS_Parser
      for a parser will be useful beyond this.  And we can always convert
      these to properties later, but not vice versa.  */
   /* When an embedded parser is created, it's usually based on a node in
-     the host parser.  This field saves that node so it possible to
+     the host parser.  This field saves that node so it's possible to
      climb up and out of the embedded parser into the host parser.  Note
      that the range of the embedded parser doesn't have to match that of
      the parent node.  */