Tree-sitter doc question

Tree-sitter doc question

[Ergus]

Hi list:

Just a quick question. I see that the tree-sitter changes are already on
master, but I don't find any documentation. Please could you point me
where is it or how to use it?

I don't know how to do very basic things like:

1) How to check if it is enabled.

2) One enabled (which I think I managed) are the colors in the text from
cc-mode or tree-sitter?

3) What are the features available? May I disable cc-mode and rely on a
pure tree-sitter experience only?

+) Any other recommendation/comment???

Best and thanks in advance,
Ergus

Re: Tree-sitter doc question

[Eli Zaretskii]

> Date: Thu, 8 Dec 2022 15:12:47 +0100
> From: Ergus <spacibba@aol.com>
> 
> Just a quick question. I see that the tree-sitter changes are already on
> master, but I don't find any documentation. Please could you point me
> where is it or how to use it?

"No documentation" is not accurate: there's a lot in the ELisp manual.

User-level documentation was not yet written, we will do that a bit
later.

> 1) How to check if it is enabled.

The modes that rely on it know how to check that.

> 2) One enabled (which I think I managed) are the colors in the text from
> cc-mode or tree-sitter?

The colors are our faces, so the answer is "neither".

> 3) What are the features available? May I disable cc-mode and rely on a
> pure tree-sitter experience only?

Yes.  But be prepared to see some unusual things, because those modes
are still WIP.

Re: Tree-sitter doc question

[Eli Zaretskii]

> Date: Thu, 8 Dec 2022 15:52:46 +0100
> From: Ergus <spacibba@aol.com>
> 
> >The modes that rely on it know how to check that.
> >
> Yes, but as I was trying to use it in C I didn't know if it was actually
> working or not as I don't see any change.

You need to turn on c-ts-mode manually, it is an opt-in feature (and
will probably remain like that in Emacs 29).

> >The colors are our faces, so the answer is "neither".
> >
> I know; maybe I needed to be more specific. As I don't know if it is
> working I don't know who was setting the syntax info.

The faces are set based on the results of parsing by the tree-sitter
library.

Re: Tree-sitter doc question

[Felix]

Eli Zaretskii <eliz@gnu.org> writes:

>> Date: Thu, 8 Dec 2022 15:52:46 +0100
>> From: Ergus <spacibba@aol.com>
>>
>> >The modes that rely on it know how to check that.
>> >
>> Yes, but as I was trying to use it in C I didn't know if it was actually
>> working or not as I don't see any change.
>
> You need to turn on c-ts-mode manually, it is an opt-in feature (and
> will probably remain like that in Emacs 29).
>
>> >The colors are our faces, so the answer is "neither".
>> >
>> I know; maybe I needed to be more specific. As I don't know if it is
>> working I don't know who was setting the syntax info.
>
> The faces are set based on the results of parsing by the tree-sitter
> library.

What would be the recommended way to enable the *-ts-mode for a certain
language?
Adding a hook to a major-mode to enable another major-mode seems a bit
backward. This is what i did first, now i added entries to auto-mode-alist.
It would be nice to have an customization variable that controls which
major-modes are replaced.
For more user feedback, it would be beneficial to have an easy way to
enable and try tree-sitter.

Re: Tree-sitter doc question

[Eli Zaretskii]

> From: Felix <felix.dick@web.de>
> Date: Thu, 08 Dec 2022 16:08:39 +0100
> 
> What would be the recommended way to enable the *-ts-mode for a certain
> language?

Change auto-mode-alist in your init file.  For example:

  (setq auto-mode-alist
	(append
	 '(("\\.[ch]\\'" . c-ts-mode))
	 auto-mode-alist))

Re: Tree-sitter doc question

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

> Change auto-mode-alist in your init file.  For example:
>
>   (setq auto-mode-alist
> 	(append
> 	 '(("\\.[ch]\\'" . c-ts-mode))
> 	 auto-mode-alist))

a.k.a.

    (add-to-list 'auto-mode-alist ("\\.[ch]\\'" . c-ts-mode))

Re: Tree-sitter doc question

[Juanma Barranquero]

[-- Attachment #1: Type: text/plain, Size: 213 bytes --]

On Thu, Dec 8, 2022 at 5:06 PM Stefan Kangas <stefankangas@gmail.com> wrote:

a.k.a.
>
>     (add-to-list 'auto-mode-alist ("\\.[ch]\\'" . c-ts-mode))
>

a.k.a.

(push '("\\.[ch]\\'" . c-ts-mode) auto-mode-alist)

[-- Attachment #2: Type: text/html, Size: 942 bytes --]

Re: Tree-sitter doc question

[Felix]

Juanma Barranquero <lekktu@gmail.com> writes:

> On Thu, Dec 8, 2022 at 5:06 PM Stefan Kangas <stefankangas@gmail.com> wrote:
>
>  a.k.a.
>
>      (add-to-list 'auto-mode-alist ("\\.[ch]\\'" . c-ts-mode))
>
>
> a.k.a.
>
> (push '("\\.[ch]\\'" . c-ts-mode) auto-mode-alist)


spoiled for choice, again!

RE: [External] : Re: Tree-sitter doc question

[Drew Adams]

>>> a.k.a.
>>> (add-to-list 'auto-mode-alist ("\\.[ch]\\'" . c-ts-mode))
>> a.k.a.
>> (push '("\\.[ch]\\'" . c-ts-mode) auto-mode-alist)
> 
> spoiled for choice, again!

Yes, but not if the first arg to `add-to-list'
is computed instead of just a quoted symbol.

(defun foo () (intern (concat "auto-" "mode-alist")))

(add-to-list (foo) ("\\.[ch]\\'" . c-ts-mode))

Re: Tree-sitter doc question

[Eli Zaretskii]

> From: Juanma Barranquero <lekktu@gmail.com>
> Date: Thu, 8 Dec 2022 17:24:08 +0100
> Cc: Eli Zaretskii <eliz@gnu.org>, Felix <felix.dick@web.de>, emacs-devel@gnu.org
> 
> On Thu, Dec 8, 2022 at 5:06 PM Stefan Kangas <stefankangas@gmail.com> wrote:
> 
>  a.k.a.
> 
>      (add-to-list 'auto-mode-alist ("\\.[ch]\\'" . c-ts-mode))
> 
>  
> a.k.a.
> 
> (push '("\\.[ch]\\'" . c-ts-mode) auto-mode-alist)

And then we wonder why newbies on help-gnu-emacs cannot find their way
around...

Re: Tree-sitter doc question

[Eli Zaretskii]

> From: Felix <felix.dick@web.de>
> Cc: Stefan Kangas <stefankangas@gmail.com>, Eli Zaretskii <eliz@gnu.org>,
>  emacs-devel@gnu.org
> Date: Thu, 08 Dec 2022 17:29:52 +0100
> 
> 
> Juanma Barranquero <lekktu@gmail.com> writes:
> 
> > On Thu, Dec 8, 2022 at 5:06 PM Stefan Kangas <stefankangas@gmail.com> wrote:
> >
> >  a.k.a.
> >
> >      (add-to-list 'auto-mode-alist ("\\.[ch]\\'" . c-ts-mode))
> >
> >
> > a.k.a.
> >
> > (push '("\\.[ch]\\'" . c-ts-mode) auto-mode-alist)
> 
> 
> spoiled for choice, again!

Now you get to decide whom do you listen to.

Re: Tree-sitter doc question

[Stefan Monnier]

> Adding a hook to a major-mode to enable another major-mode seems a bit
> backward. This is what i did first, now i added entries to auto-mode-alist.
> It would be nice to have an customization variable that controls which
> major-modes are replaced.

`major-mode-remap-alist`?


        Stefan