From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Yuan Fu Newsgroups: gmane.emacs.devel Subject: Re: Writing manuals Date: Tue, 17 Aug 2021 11:10:06 -0700 Message-ID: References: <60B2E271-2E91-4906-940E-425A76ED0DCD@gmail.com> <83czqc715e.fsf@gnu.org> <502702DF-70A7-4FCC-93FD-08E984673832@gmail.com> <83tujo56oj.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.60.0.2.21\)) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20096"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Aug 17 20:11:22 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mG3YY-000527-FO for ged-emacs-devel@m.gmane-mx.org; Tue, 17 Aug 2021 20:11:22 +0200 Original-Received: from localhost ([::1]:43542 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mG3YV-0008DB-PO for ged-emacs-devel@m.gmane-mx.org; Tue, 17 Aug 2021 14:11:20 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:33292) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mG3XR-0006og-4g for emacs-devel@gnu.org; Tue, 17 Aug 2021 14:10:13 -0400 Original-Received: from mail-pj1-x102d.google.com ([2607:f8b0:4864:20::102d]:35688) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mG3XP-0004qI-Kv; Tue, 17 Aug 2021 14:10:12 -0400 Original-Received: by mail-pj1-x102d.google.com with SMTP id j12-20020a17090aeb0c00b00179530520b3so6718894pjz.0; Tue, 17 Aug 2021 11:10:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=xg/RUbDNrjv6C62se1V3Nwmk86EmjdBfK9yVlHBaK+0=; b=E+swLvL7r+BWPxfR2A56AekkZ2SZBE9ffNhE4KOrt3eQ4Oi3gbaGIlOHSrr2oi4tfB sJIzDFg3Lgqfuxq0qyB4OSSGxPH7B7pq9kMfMGaFAc3eNIH9T35eYlZzTz/M6hyELa5J O+B+g9MSH/SzTObSQCo3qdfc7y3rSQz0rsrAifBamnIaITfW+zlylga/t2XixnSxaonJ oOtNqSEd0I+Z4So8OrB1ARAM/xnkjnydDIoFSDdBa6zt3IADRa/usbDSe00dmM9ylDsn DA2nMw1qn/K7ScRwAAYEwe85QVCbLVwrLenu53M00YalC+g27iXYarUGCxvw8LKIWMIU jD1g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:subject:from:in-reply-to:date:cc :content-transfer-encoding:message-id:references:to; bh=xg/RUbDNrjv6C62se1V3Nwmk86EmjdBfK9yVlHBaK+0=; b=WAGO/glzIaQpSsADPZelv/MqOxIB/r3wa7i+dhqQUpZpONHWwpgfSvO3M6mPLUZOkh 6DJSSJL8rVW6+J77b+uFgp/OvhylztwDP+go1+amcPkMw3V+u0Dd7N0m6q7plsDVPkNo KARcIKEYbQNwwb6+v3HV5KYLAg3Nz3nWxpNj2gVpmyB9DcooTrdp0anHAzVzct0R2J8p w2FDFoxRxU0rsXlaBZIgTd314DgN5kecgCMzF9Hs5TrmdXGLzp70OQW3MU35f5SZ46dL V3RG5xa3vPVfY8YTg9ud7wNgMtV6iUetuXOD9W78H0hnUeoyvzu6AWv1mtC/KcW5CEKB kEhg== X-Gm-Message-State: AOAM533NFFWbHhjQ2D5wO7cyTHjw6FBgylGAWMMfnZhX5dyfhIE5Krj3 lN2wqOleFyDCD7GWktG2PG1X6eVwgdo= X-Google-Smtp-Source: ABdhPJzPtdwZOLj9dD20vaum6rGKcrGhD9AQNcLB53mq7rX1/wopEHHGfNHQUUk0uyW+W4MU8Tn3sA== X-Received: by 2002:a63:7883:: with SMTP id t125mr4643120pgc.243.1629223808456; Tue, 17 Aug 2021 11:10:08 -0700 (PDT) Original-Received: from 2603-8000-d900-871b-4c36-40c4-14eb-a734.res6.spectrum.com (2603-8000-d900-871b-4c36-40c4-14eb-a734.res6.spectrum.com. [2603:8000:d900:871b:4c36:40c4:14eb:a734]) by smtp.gmail.com with ESMTPSA id g6sm3251432pfv.156.2021.08.17.11.10.07 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 17 Aug 2021 11:10:08 -0700 (PDT) In-Reply-To: <83tujo56oj.fsf@gnu.org> X-Mailer: Apple Mail (2.3654.60.0.2.21) Received-SPF: pass client-ip=2607:f8b0:4864:20::102d; envelope-from=casouri@gmail.com; helo=mail-pj1-x102d.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:272508 Archived-At: > On Aug 17, 2021, at 10:20 AM, Eli Zaretskii wrote: >=20 >> From: Yuan Fu >> Date: Tue, 17 Aug 2021 09:28:53 -0700 >> Cc: emacs-devel >>=20 >>>> 3. Where should I put the tree-sitter node in the manual? >>>=20 >>> 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. >>=20 >> 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. >=20 > 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=E2=80=99s under? Text? Yuan=