Re: master 3c50edb2b50 2/3: Add new variable 'down-list-function' for 'treesit-down-list'

[Eli Zaretskii]

> From: Juri Linkov <juri@jurta.org>
> Cc: emacs-diffs@gnu.org
> Date: Mon, 30 Dec 2024 09:05:44 +0200
> 
> This is not a command intended for users.  If the interactive spec
> is a problem, it can be removed.  Is this what you would prefer?

Then the problem I see in the documentation of these new features that
navigate sexp-lists will simply wander elsewhere: NEWS, navigation
commands which call these functions for TS-based modes, etc.

My point is that the concept and effects of these navigations is not
documented in terms that can be easily understood and grasped by Emacs
users.  We must fill this void somehow.

Commands like up-list are self-explanatory when applied to Lisp-like
languages.  But here we extended and generalized that to programming
languages which look nothing like Lisp, so we must document what this
means in those other languages.  It is not easy to document such
abstraction levels, but we must try.

Are there any major modes which use these features already?  If you
point me to them, I could try improving the documentation myself.