GNU bug report logs - #59627
29.0.50; tree-sitter support not documented in emacs manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 59627 in the body.
You can then email your comments to 59627 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefankangas <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 29.0.50; tree-sitter support not documented in emacs manual
Date: Sun, 27 Nov 2022 01:38:40 -0800

The new tree-sitter support is not documented in the emacs manual, only
in the elisp one.  Should it be?

Message #8 received at 59627 <at> debbugs.gnu.org (full text, mbox):

From: Theodor Thornhill <theo <at> thornhill.no>
To: Stefan Kangas <stefankangas <at> gmail.com>, 59627 <at> debbugs.gnu.org
Cc: Yuan Fu <casouri <at> gmail.com>
Subject: Re: bug#59627: 29.0.50; tree-sitter support not documented in emacs
 manual
Date: Sun, 27 Nov 2022 12:41:40 +0100

Stefan Kangas <stefankangas <at> gmail.com> writes:

> The new tree-sitter support is not documented in the emacs manual, only
> in the elisp one.  Should it be?

To me it seems like the Emacs manual covers broader strokes and
concepts, while tree-sitter still is "just" an internal implementation
detail.  I'm not sure exactly where this distinction goes, though.

Theo

Message #11 received at 59627 <at> debbugs.gnu.org (full text, mbox):

From: Yuan Fu <casouri <at> gmail.com>
To: Theodor Thornhill <theo <at> thornhill.no>
Cc: 59627 <at> debbugs.gnu.org, Stefan Kangas <stefankangas <at> gmail.com>
Subject: Re: bug#59627: 29.0.50; tree-sitter support not documented in emacs
 manual
Date: Sun, 27 Nov 2022 14:27:53 -0800

> On Nov 27, 2022, at 3:41 AM, Theodor Thornhill <theo <at> thornhill.no> wrote:
> 
> Stefan Kangas <stefankangas <at> gmail.com> writes:
> 
>> The new tree-sitter support is not documented in the emacs manual, only
>> in the elisp one.  Should it be?
> 
> To me it seems like the Emacs manual covers broader strokes and
> concepts, while tree-sitter still is "just" an internal implementation
> detail.  I'm not sure exactly where this distinction goes, though.
> 
> Theo

I think the plans is to add a section in the Emacs manual. There are some functions and variables intended to be included in the Emacs manual that I left out of the Elisp manual. The Emacs manual should also explain font-lock features.

Yuan

Message #16 received at 59627-done <at> debbugs.gnu.org (full text, mbox):

From: Yuan Fu <casouri <at> gmail.com>
To: Theodor Thornhill <theo <at> thornhill.no>
Cc: 59627-done <at> debbugs.gnu.org, stefankangas <at> gmail.com
Subject: Re: bug#59627: 29.0.50; tree-sitter support not documented in emacs 
 manual
Date: Sat, 7 Jan 2023 15:00:19 -0800

Yuan Fu <casouri <at> gmail.com> writes:

>> On Nov 27, 2022, at 3:41 AM, Theodor Thornhill <theo <at> thornhill.no> wrote:
>> 
>> Stefan Kangas <stefankangas <at> gmail.com> writes:
>> 
>>> The new tree-sitter support is not documented in the emacs manual, only
>>> in the elisp one.  Should it be?
>> 
>> To me it seems like the Emacs manual covers broader strokes and
>> concepts, while tree-sitter still is "just" an internal implementation
>> detail.  I'm not sure exactly where this distinction goes, though.
>> 
>> Theo
>
> I think the plans is to add a section in the Emacs manual. There are
> some functions and variables intended to be included in the Emacs
> manual that I left out of the Elisp manual. The Emacs manual should
> also explain font-lock features.

I think there is not need to keep this open as an reminder. IIUC Eli is
working on the Emacs manual. So I’m closing this.

Yuan

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.