From 247743bd1e99821e111a838ca5070c5ba057ac1c Mon Sep 17 00:00:00 2001 From: Yuan Fu Date: Tue, 26 Sep 2023 23:15:14 -0700 Subject: [PATCH] ; * lisp/treesit.el (treesit-language-at-point-function): Fix doc. (cherry picked from commit 07ede5e92a58ac3739a0e5b0c9025bee2f75c5ba) (Bug#66183) --- lisp/treesit.el | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) 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. -- 2.39.2