Add note on tree-sitter's naming convention

* admin/notes/tree-sitter/starter-guide: Add note.
* doc/lispref/parsing.texi: Add note.

diff --git a/admin/notes/tree-sitter/starter-guide b/admin/notes/tree-sitter/starter-guide
index 129f9ee5fa46af01ea3a071b3b98fa875d1f94aa..378ff581afa3ce3adbf6fa91de6729c835994f9e 100644 (file)
--- a/admin/notes/tree-sitter/starter-guide
+++ b/admin/notes/tree-sitter/starter-guide
@@ -8,6 +8,7 @@ TOC:
 - Building Emacs with tree-sitter
 - Install language definitions
 - Setup
+- Naming convention
 - Font-lock
 - Indent
 - Imenu
@@ -94,6 +95,12 @@ Then in other places, we decide on whether to enable tree-sitter by
      (treesit-can-enable-p))
 #+end_src
 
+* Naming convention
+
+When referring to tree-sitter as a noun, use “tree-sitter”, like
+python-use-tree-sitter. For prefix use “treesit”, like
+python-treesit-indent.
+
 * Font-lock
 
 Tree-sitter works like this: You provide a query made of patterns and

diff --git a/doc/lispref/parsing.texi b/doc/lispref/parsing.texi
index 3784531fe591d95c44279b6ffe5ce8c031af4c9b..d0bb642a3e0864e6a8f7958ea478d9a0a1a66958 100644 (file)
--- a/doc/lispref/parsing.texi
+++ b/doc/lispref/parsing.texi
@@ -30,6 +30,10 @@ For tree-sitter integration with existing Emacs features,
 @pxref{Parser-based Font Lock}, @ref{Parser-based Indentation}, and
 @ref{List Motion}.
 
+About naming convention: use ``tree-sitter'' when referring to it as a
+noun, like @code{python-use-tree-sitter}, but use ``treesit'' for
+prefixes, like @code{python-treesit-indent-function}.
+
 To access the syntax tree of the text in a buffer, we need to first
 load a language definition and create a parser with it.  Next, we can
 query the parser for specific nodes in the syntax tree.  Then, we can