emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Writing manuals


From: Yuan Fu
Subject: Re: Writing manuals
Date: Tue, 17 Aug 2021 13:08:52 -0700


> On Aug 17, 2021, at 11:35 AM, Eli Zaretskii <eliz@gnu.org> wrote:
> 
>> From: Yuan Fu <casouri@gmail.com>
>> Date: Tue, 17 Aug 2021 11:10:06 -0700
>> Cc: emacs-devel@gnu.org
>> 
>>> I'm not sure I see the difference.  We have syntax-ppss
>>> etc. documented in the ELisp manual; how are TS-related APIs
>>> different?
>> 
>> It certainly should be in the ELisp manual, I mean which node should I put 
>> tree-sitter API’s under? Text?
> 
> No, "Text" is for other stuff.  I think a separate chapter, something
> like "Parsing Program Source".  As long as you are talking about
> general-purpose parsing functions, not their use for font-lock etc.

Ok, I would name it “Parsing Program Source with Tree-sitter”, because it isn’t 
a generic parsing facility, but really a tree-sitter integration.

Another question, do I need to @vindex a variable every time I mention it, or I 
only need to @vindex it once, at where I explain the variable?

Yuan


reply via email to

[Prev in Thread] Current Thread [Next in Thread]