summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYuan Fu <casouri@gmail.com>2023-09-26 23:15:14 -0700
committerEli Zaretskii <eliz@gnu.org>2023-10-07 12:03:37 +0300
commit247743bd1e99821e111a838ca5070c5ba057ac1c (patch)
tree698dae3ea99e61a22f8b7aba2f7d37455980c78e
parenta74e51cfd1518507220de2ba317bb862409541cf (diff)
downloademacs-247743bd1e99821e111a838ca5070c5ba057ac1c.tar.gz
; * lisp/treesit.el (treesit-language-at-point-function): Fix doc.
(cherry picked from commit 07ede5e92a58ac3739a0e5b0c9025bee2f75c5ba) (Bug#66183)
-rw-r--r--lisp/treesit.el9
1 files changed, 8 insertions, 1 deletions
diff --git a/lisp/treesit.el b/lisp/treesit.el
index c24ea90bba0..98eac7f6d63 100644
--- 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.