[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#60983: 29.0.60; Tree-sitter user-level control
From: |
Eli Zaretskii |
Subject: |
bug#60983: 29.0.60; Tree-sitter user-level control |
Date: |
Sun, 05 Feb 2023 08:01:14 +0200 |
> From: Yuan Fu <casouri@gmail.com>
> Date: Sat, 4 Feb 2023 15:38:17 -0800
> Cc: Bug Report Emacs <bug-gnu-emacs@gnu.org>,
> theo@thornhill.no
>
> > treesit-font-lock-recompute-features is a non-interactive function, so
> > mentioning it in the user manual is generally inappropriate. Users
> > are unlikely to add features that aren't already defined in the mode's
> > font-lock setup.
> >
> > This function and its use in these situations are described in the
> > ELisp manual, where I think it belongs.
> >
> > As for the fact that changing treesit-font-lock-feature-list directly
> > doesn't have any effect, that is already in the doc string. I'm not
> > opposed to mentioning that in the manual as well, but I see no problem
> > with what we have.
>
> I see. Sounds good to me. I meant enabling/disabling features when I say
> “adding/removing” features. Does that make anything different?
Yes, that's how I understood what you were saying: changing the list
of features enabled/disabled by specific levels. This is not a
user-level thing, so describing it in the ELisp manual is good enough,
I think. (If it turns out users want to do this kind of thing too
often, it probably means our design of the user-facing features is
sub-optimal and should be improved.)