Re: Writing manuals

[Yuan Fu]

> On Aug 17, 2021, at 10:20 AM, Eli Zaretskii <eliz@gnu.org> wrote:
> 
>> From: Yuan Fu <casouri@gmail.com>
>> Date: Tue, 17 Aug 2021 09:28:53 -0700
>> Cc: emacs-devel <emacs-devel@gnu.org>
>> 
>>>> 3. Where should I put the tree-sitter node in the manual?
>>> 
>>> You mean, in the ELisp manual?  I think each group of APIs should be
>>> described where it belongs: the fontification-related APIs where
>>> font-lock is described, indentation-related APIs where indentation
>>> facilities are documented, etc.
>> 
>> I was referring to tree-sitter API, i.e., wrappers of tree-sitter functions. 
>> They are the functions that I expect to not change much. Font-lock and 
>> indent API are still undecided for the most part. So where should I put the 
>> manual of tree-sitter functions? In that node I will talk about what can 
>> tree-sitter do and how to use the parser and parse-tree, etc.
> 
> 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?

Yuan