Re: master 4efe3b99a5d 2/2: Document tree-sitter things feature (bug#70016) (bug#68824)

[Yuan Fu <casouri@gmail.com>]

> On Apr 13, 2024, at 2:12 AM, Eli Zaretskii <eliz@gnu.org> wrote:
> 
>> From: Michael Albinus <michael.albinus@gmx.de>
>> Cc: Yuan Fu <casouri@gmail.com>
>> Date: Mon, 08 Apr 2024 09:28:49 +0200
>> 
>> Yuan Fu <casouri@gmail.com> writes:
>> 
>> Hi,
>> 
>>> diff --git a/etc/NEWS b/etc/NEWS
>>> index d4bba66e4aa..b2543ae77d9 100644
>>> --- a/etc/NEWS
>>> +++ b/etc/NEWS
>>> @@ -2380,6 +2380,35 @@ objects is still necessary.
>>> ** The JSON encoder and decoder now accept arbitarily large integers.
>>> Previously, they were limited to the range of signed 64-bit integers.
>>> 
>>> +** New tree-sitter functions and variables for defining and using "things"
>>> +
>>> ++++
>>> +*** New variable 'treesit-thing-settings'.
>>> +
>>> +New variable that allows users to define "things" like 'defun', 'text',
>>> +'sexp', for navigation commands and tree-traversal functions.
>>> +
>>> ++++
>>> +*** New navigation functions 'treesit-thing-prev', 'treesit-thing-next', 'treesit-navigate-thing', 'treesit-beginning-of-thing', 'treesit-end-of-thing'.
>>> +
>>> ++++
>>> +*** New functions 'treesit-thing-at', 'treesit-thing-at-point'.
>>> +
>>> ++++
>>> +*** Tree-tarversing functions 'treesit-search-subtree', 'treesit-search-forward', 'treesit-search-forward-goto', 'treesit-induce-sparse-tree' now accepts more kinds of predicates.
>>> +
>>> +Now users can use thing symbols (defined in 'treesit-thing-settings'),
>>> +and any thing definitions for the predicate argument.
>>> +
>>> +** Other tree-sitter function and variable changes
>>> +
>>> ++++
>>> +*** 'treesit-parser-list' now takes additional optional arguments, LANGUAGE and TAG.
>>> +
>>> +If LANGUAGE is given, only return parsers for that language.  If TAG is
>>> +given, only return parsers with that tag.  Note that passing nil as tag
>>> +doesn't mean return all parsers, but rather "all parsers with no tags".
>>> +
>>> 
>>> * Changes in Emacs 30.1 on Non-Free Operating Systems
>>> 
>> 
>> Could you please adjust this to the etc/NEWS convention max line length 80?
> 
> I believe I did that today.

Thanks to you both, Eli and Michael.

Yuan