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

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

[Michael Albinus]

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".
> +
>  \f
>  * Changes in Emacs 30.1 on Non-Free Operating Systems
>

Could you please adjust this to the etc/NEWS convention max line length 80?

Best regards, Michael.

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

[Basil L. Contovounesios]

Michael Albinus [2024-04-08 09:28 +0200] wrote:
> Yuan Fu <casouri@gmail.com> writes:
>> diff --git a/etc/NEWS b/etc/NEWS
>> +*** Tree-tarversing functions 'treesit-search-subtree',

Please also tarversing -> traversing.

> Could you please adjust this to the etc/NEWS convention max line length 80?

Thanks!
-- 
Basil

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

[Eli Zaretskii]

> 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".
> > +
> >  \f
> >  * 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.

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

[Yuan Fu]

> 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