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.bugs Subject: bug#59627: 29.0.50; tree-sitter support not documented in emacs manual Date: Sun, 27 Nov 2022 14:27:53 -0800 Message-ID: <13C3635A-44ED-433D-9EFE-EA3EBF5E9692@gmail.com> References: <87y1rw1v63.fsf@thornhill.no> Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.1\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30368"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 59627@debbugs.gnu.org, Stefan Kangas To: Theodor Thornhill Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Nov 27 23:29:39 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1ozQ9b-0007gN-FJ for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 27 Nov 2022 23:29:39 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ozQ92-0006Om-M2; Sun, 27 Nov 2022 17:29:04 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ozQ91-0006OM-Au for bug-gnu-emacs@gnu.org; Sun, 27 Nov 2022 17:29:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ozQ91-0002XV-2r for bug-gnu-emacs@gnu.org; Sun, 27 Nov 2022 17:29:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ozQ8z-0001YJ-VX for bug-gnu-emacs@gnu.org; Sun, 27 Nov 2022 17:29:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Yuan Fu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Nov 2022 22:29:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59627 X-GNU-PR-Package: emacs Original-Received: via spool by 59627-submit@debbugs.gnu.org id=B59627.16695880835959 (code B ref 59627); Sun, 27 Nov 2022 22:29:01 +0000 Original-Received: (at 59627) by debbugs.gnu.org; 27 Nov 2022 22:28:03 +0000 Original-Received: from localhost ([127.0.0.1]:44556 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozQ82-0001Y3-L6 for submit@debbugs.gnu.org; Sun, 27 Nov 2022 17:28:02 -0500 Original-Received: from mail-pf1-f180.google.com ([209.85.210.180]:33533) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ozQ80-0001Xg-HT for 59627@debbugs.gnu.org; Sun, 27 Nov 2022 17:28:01 -0500 Original-Received: by mail-pf1-f180.google.com with SMTP id a9so5347006pfr.0 for <59627@debbugs.gnu.org>; Sun, 27 Nov 2022 14:28:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=TU6yyDdo/SCZxpAKnQO0mzh832HxbZ61L+TFQT0R/LE=; b=NebVQ6aICWZryCeG+FIXTaMDhWxQCZpxoBjeH6j7NM7/Z11xE0kTCRSQ5NFULwFTP2 ECZ6TpKnYkqap4Yb2KRLPLzx1Jw4cQsBhnBwoTJRWXLBWOzEDj8B/EDjNN5dzUsWZ5oc njqRbEmqccoOTxDfGIW04ByDRypTT/nvuz7an5mA0MFF4Picj9Bp59gAHhbo69bjuavN c9iGOq7zCxaiRE9tkSQvDNwAnwfQnrBcAIhOn9Iz7fp/P8bJ0RqKzqpzI//YfzF/oKvr etgowTJwobloRtVJeJZbTkOeguQhmnVPvSqfj6r/HdGv3W1X+f5DZ4l8MiaTSIZM/W9r vISQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=TU6yyDdo/SCZxpAKnQO0mzh832HxbZ61L+TFQT0R/LE=; b=tLsFQIg2pySaJFr6Of4t3CMWi0uKacBDSJNCkT3vEY1W2GDcokZzy6FW9MteNKIhxV ckpxUyvtBD1ejG6AUDEz8P8o1YycKDJVihXVA9eDT4L3MaJgieiOMupxcA0LCHZk1DSy LgR0+iB0LBcWVuR+X926QOmIInI37rFXc1JsJMjaIF71drlep6q2mOplYvEhX43OgF7u t9njMLuD0P9ITY9kvQVUfcphbwxrZu128FkUHUckygcnDTjq0cWB4RZ/hxKbV8cAncil zuw0e3zQT4Q5ARZzpapqxf+moYwfAw/3n7DW9NylB6whyR0XxVeV7XxF+ZybpMNHUQwn FB7w== X-Gm-Message-State: ANoB5pm5/ejeNgB705+JbvRWpGqN3JlXRtlpXFOZ2wD+cBNQoN9FKQoV HwwvNyqY4Y6g9icVAPucU0k= X-Google-Smtp-Source: AA0mqf623ocXzHOftU9OCNbpD38mtMtlLdl5C/QPdFFAgvO920BmKGNsM/SQLAjb2a71dq4Cz04X4Q== X-Received: by 2002:a65:4c42:0:b0:477:f872:8b6 with SMTP id l2-20020a654c42000000b00477f87208b6mr7741430pgr.457.1669588074784; Sun, 27 Nov 2022 14:27:54 -0800 (PST) Original-Received: from smtpclient.apple (cpe-172-117-161-177.socal.res.rr.com. [172.117.161.177]) by smtp.gmail.com with ESMTPSA id p16-20020a634f50000000b0046fefb18a09sm5510524pgl.91.2022.11.27.14.27.53 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sun, 27 Nov 2022 14:27:54 -0800 (PST) In-Reply-To: <87y1rw1v63.fsf@thornhill.no> X-Mailer: Apple Mail (2.3696.120.41.1.1) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:249253 Archived-At: > On Nov 27, 2022, at 3:41 AM, Theodor Thornhill = wrote: >=20 > Stefan Kangas writes: >=20 >> The new tree-sitter support is not documented in the emacs manual, = only >> in the elisp one. Should it be? >=20 > 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. >=20 > 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=