; Improve recently-modified documentation

* lisp/progmodes/python.el (python-base-mode)
(python--treesit-fontify-string):
* lisp/textmodes/css-mode.el (css-base-mode):
* lisp/treesit.el (treesit-ready-p, treesit-comment-end)
(treesit-simple-indent-presets): Fix typos and wording in doc strings.

* doc/lispref/parsing.texi (Tree-sitter major modes):
* doc/lispref/modes.texi (Parser-based Indentation): Fix wording
and add cross-references.

3 files changed, 13 insertions, 13 deletions

diff --git a/lisp/progmodes/python.el b/lisp/progmodes/python.el
index d16aeaf0133..2f967ebab24 100644
--- a/lisp/progmodes/python.el
+++ b/lisp/progmodes/python.el
@@ -1016,7 +1016,7 @@ It makes underscores and dots word constituent chars.")
   "Fontify string.
 NODE is the string node.  Do not fontify the initial f for
 f-strings.  OVERRIDE is the override flag described in
-`treesit-font-lock-rules'.  START and END marks the region to be
+`treesit-font-lock-rules'.  START and END mark the region to be
 fontified."
   (let* ((string-beg (treesit-node-start node))
          (string-end (treesit-node-end node))
@@ -6482,8 +6482,8 @@ Add import for undefined name `%s' (empty to skip): "
 (define-derived-mode python-base-mode prog-mode "Python"
   "Generic major mode for editing Python files.
 
-This is a generic major mode intended to be inherited by a
-concrete implementations.  Currently there two concrete
+This is a generic major mode intended to be inherited by
+concrete implementations.  Currently there are two concrete
 implementations: `python-mode' and `python-ts-mode'."
   (setq-local tab-width 8)
   (setq-local indent-tabs-mode nil)
diff --git a/lisp/textmodes/css-mode.el b/lisp/textmodes/css-mode.el
index 34380c05a00..6915e499bba 100644
--- a/lisp/textmodes/css-mode.el
+++ b/lisp/textmodes/css-mode.el
@@ -1751,7 +1751,7 @@ rgb()/rgba()."
   "Generic mode to edit Cascading Style Sheets (CSS).
 
 This is a generic major mode intended to be inherited by a
-concrete implementation.  Currently there two concrete
+concrete implementation.  Currently there are two concrete
 implementations: `css-mode' and `css-ts-mode'."
   (setq-local comment-start "/*")
   (setq-local comment-start-skip "/\\*+[ \t]*")
diff --git a/lisp/treesit.el b/lisp/treesit.el
index 76cefbbaf32..674c984dfe5 100644
--- a/lisp/treesit.el
+++ b/lisp/treesit.el
@@ -822,15 +822,15 @@ parser notifying of the change."
 
 ;;; Indent
 
-;; `comment-start' and `comment-end' assumes there is only one type of
-;; comment and comment spans only one line.  So they are not
+;; `comment-start' and `comment-end' assume there is only one type of
+;; comment, and that the comment spans only one line.  So they are not
 ;; sufficient for our purpose.
 
 (defvar-local treesit-comment-start nil
   "Regular expression matching an opening comment token.")
 
 (defvar-local treesit-comment-end nil
-  "Regular expression matching an closing comment token.")
+  "Regular expression matching a closing comment token.")
 
 (define-error 'treesit-indent-error
               "Generic tree-sitter indentation error"
@@ -1069,14 +1069,14 @@ point-min
 
 comment-start
 
-    Returns the ending position after matching `treesit-comment-start'.
-    Assuming PARENT is a comment node.
+    Returns the position after a match for `treesit-comment-start'.
+    Assumes PARENT is a comment node.
 
 comment-start-skip
 
-    Goes to the position comment-start would return, skip
-    whitespaces forward, and return the resulting position.
-    Assuming PARENT is a comment node.")
+    Goes to the position that comment-start would return, skips
+    whitespace after that, and returns the resulting position.
+    Assumes PARENT is a comment node.")
 
 (defun treesit--simple-indent-eval (exp)
   "Evaluate EXP.
@@ -1463,7 +1463,7 @@ LANGUAGE is the language symbol to check for availability.
 It can also be a list of language symbols.
 
 If tree-sitter is not ready, emit a warning and return nil.  If
-the user has chosen to activate tree-sitter for MODE and
+the user has chosen to activate tree-sitter for LANGUAGE and
 tree-sitter is ready, return non-nil.  If QUIET is t, don't emit
 warning in either case; if quiet is `message', display a message
 instead of emitting warning."