From: Yuan Fu <casouri@gmail.com>
Date: Wed, 27 Sep 2023 06:15:14 +0000 (-0700)
Subject: ; * lisp/treesit.el (treesit-language-at-point-function): Fix doc.
X-Git-Tag: emacs-29.1.90~22
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=247743bd1e99821e111a838ca5070c5ba057ac1c;p=emacs.git

; * 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 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.