; * lisp/treesit.el (treesit-language-at-point-function): Fix doc.

(cherry picked from commit 07ede5e92a58ac3739a0e5b0c9025bee2f75c5ba)
(Bug#66183)

diff --git a/lisp/treesit.el b/lisp/treesit.el
index c24ea90bba0ebb57636837735f71379703b96324..98eac7f6d639caaa6be527b1f06d71420c5e65fa 100644 (file)
--- a/lisp/treesit.el
+++ b/lisp/treesit.el
@@ -132,7 +132,14 @@ Return the root node of the syntax tree."
 This is used by `treesit-language-at', which is used by various
 functions to determine which parser to use at point.
 
-The function is called with one argument, the position of point.")
+The function is called with one argument, the position of point.
+
+In general, this function should call `treesit-node-at' with an
+explicit language (usually the host language), and determine the
+language at point using the type of the returned node.
+
+DO NOT derive the language at point from parser ranges.  It's
+cumbersome and can't deal with some edge cases.")
 
 (defun treesit-language-at (position)
   "Return the language at POSITION.