From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Perry Smith Newsgroups: gmane.emacs.devel Subject: Re: Tree-sitter introduction documentation Date: Fri, 16 Dec 2022 11:23:05 -0600 Message-ID: References: <83edszjslp.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3731.200.110.1.12\)) Content-Type: multipart/signed; boundary="Apple-Mail=_ADF92DAC-BFF6-420E-94CD-073B101F6BCA"; protocol="application/pgp-signature"; micalg=pgp-sha256 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="415"; 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 Fri Dec 16 18:23:38 2022 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 1p6EQs-000ATm-G3 for ged-emacs-devel@m.gmane-mx.org; Fri, 16 Dec 2022 18:23:38 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p6EQk-0006Qi-6n; Fri, 16 Dec 2022 12:23:30 -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 1p6EQh-0006LO-JW for emacs-devel@gnu.org; Fri, 16 Dec 2022 12:23:27 -0500 Original-Received: from poodle.tulip.relay.mailchannels.net ([23.83.218.249]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p6EQf-00075y-B2; Fri, 16 Dec 2022 12:23:27 -0500 X-Sender-Id: a2hosting|x-authuser|pedz+easesoftware.com@mi3-ss4.a2hosting.com Original-Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id 7F89D101C6B; Fri, 16 Dec 2022 17:23:19 +0000 (UTC) Original-Received: from mi3-ss4.a2hosting.com (unknown [127.0.0.6]) (Authenticated sender: a2hosting) by relay.mailchannels.net (Postfix) with ESMTPA id AA5C61012F9; Fri, 16 Dec 2022 17:23:18 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1671211398; a=rsa-sha256; cv=none; b=U1G9UZkiwinRKkCi+57E0yA6XSFGz8ob2lndkST/VSS4YxrxQKRibLoAYBQX6ST4pSbbrd iSmYHEdH/Y7p1O5GBxuKFVWR6hfbueeSx7eVx7cNbtuI0bDecqJwfiNlnIipr+pxSrHvKJ hzaqZlKsi1tenEpCjPshY+di+XM2fT7/YNT1UOyezqvut5lRNkut4+oMTIrufyaR+IOB+s x9zNSKecGME6ciiIByeY3lnhHnLT2wHWGZ6s+wj+DTbcGQMDyNU3oSb2fyhOfz9E3MkpH6 shkeZ8F7t594h6ZKYjxnCRmSWpDLXJdjB/z0JjuS6awytjl8FsGzDOraHp1dWA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1671211398; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references:dkim-signature; bh=aPb2/aPjLvYN7BeE+HXF8gtT8PrvA3qUt3DGOp90jk4=; b=6/cj76V3qwgrAg6+7w7oTD78hyMXREA+kbJoe17BBHscTozfO2t4Q3H0GD/BKbBbh/8cHR BxcdLuRNpvN4XCXVYxLCzPo9QRzG4bYobKzF5p1PpIKOfXk1UXrP3bHWClkTD3X+qZ3zPD DWnwcAnClQqhLxNg+XJH1Fnw4gTLyLyMQR559fc02cyHo+XQoOuNkrZzd9zSQAi+mcqvxl PsIMUKaB17x320zuz1cKQVsE33SjIM0EECYWptW8PeG0OoRTUO4rGt5iIfAtdyGQsqmxXS 9RXjf3i69QCNTq5MAadU76sqaA/0hR/hsmHdfL+GXA1mJxIl9KBVFIAa42zUyg== ARC-Authentication-Results: i=1; rspamd-56db58bdfc-dxfct; auth=pass smtp.auth=a2hosting smtp.mailfrom=pedz@easesoftware.com X-Sender-Id: a2hosting|x-authuser|pedz+easesoftware.com@mi3-ss4.a2hosting.com X-MC-Relay: Neutral X-MailChannels-SenderId: a2hosting|x-authuser|pedz+easesoftware.com@mi3-ss4.a2hosting.com X-MailChannels-Auth-Id: a2hosting X-Thoughtful-Versed: 2fa9ebf01d86a7fc_1671211399106_2686344113 X-MC-Loop-Signature: 1671211399106:688341112 X-MC-Ingress-Time: 1671211399106 Original-Received: from mi3-ss4.a2hosting.com (mi3-ss4.a2hosting.com [68.66.200.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384) by 100.103.24.117 (trex/6.7.1); Fri, 16 Dec 2022 17:23:19 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=easesoftware.com; s=default; h=To:References:Message-Id:Cc:Date:In-Reply-To :From:Subject:Mime-Version:Content-Type:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=aPb2/aPjLvYN7BeE+HXF8gtT8PrvA3qUt3DGOp90jk4=; b=LUssNigl2djWVP+c7aDTsxAN4S CXdW4ktNdJZbHUVy1T0i0vI+NxYsfANI9VR5l/hmIlvPc4/LMKKxjxgtwwxHNsOmP3pI2J/MWpFEY aMZ+fkLndhdCvPFAWaORvVSTDVCvU2ncjUeovLpwCZYQa9pVfMLa6gaTG/zmv85flNys7s+bkbfBm vklumZp+hbdaBfOmDvOjKmy6s51UE1A6n5OfkPa++G6oIe4pdfGUo0fkt/jApUC1jkeWFp2eeNsAj GZpx9hDLpgb98Ovm4wUfzYZLoFwcVViUf8NRs/kEIbjB78RbRCvEEpKif8zRzceQwLsZcQsMYSbve ep9Evaeg==; Original-Received: from cpe-70-94-128-193.satx.res.rr.com ([70.94.128.193]:59133 helo=smtpclient.apple) by mi3-ss4.a2hosting.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.95) (envelope-from ) id 1p6EQX-005vMc-Mp; Fri, 16 Dec 2022 12:23:17 -0500 In-Reply-To: <83edszjslp.fsf@gnu.org> X-Mailer: Apple Mail (2.3731.200.110.1.12) X-AuthUser: pedz+easesoftware.com@mi3-ss4.a2hosting.com Received-SPF: pass client-ip=23.83.218.249; envelope-from=pedz@easesoftware.com; helo=poodle.tulip.relay.mailchannels.net 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, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, 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.29 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:301512 Archived-At: --Apple-Mail=_ADF92DAC-BFF6-420E-94CD-073B101F6BCA Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 > On Dec 16, 2022, at 09:06, Eli Zaretskii wrote: >=20 >=20 >> If not, and others agree, how can I help create one? I am thinking = the entire page should be small and brief with references to more = elaborate details on each of the four steps if needed. >=20 > My main problem is where to put this stuff. There are tree sitter Info pages in the ELisp topic but I would add some = to Emacs topic as well. Perhaps under Advanced Features Tree Sitter Setup and Getting Started Font lock =E2=80=94 describe the =E2=80=9Cfeatures=E2=80=9D = concept, treesit-font-lock-level and = treesit-font-lock-recompute-features The other topics seem more appropriate in ELisp which already exist. --Apple-Mail=_ADF92DAC-BFF6-420E-94CD-073B101F6BCA Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=signature.asc Content-Type: application/pgp-signature; name=signature.asc Content-Description: Message signed with OpenPGP -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEE5yOa/gCtQpb3oCpljxzk9yzE+MAFAmOcqXkACgkQjxzk9yzE +MAlxg//cKmmF4M9fvRlR74acweKuhmWBcE1djIeYHnejZ976fqonPX7iZW09t2K bNzw1BtQ9xXNzAW+IsWwLsg0Ilax4PHEfmuqqU28T0Zo6rFgF7ReaXF4aKDljDwH AGvAOVeXH0uDJ4cAGdOHmlnb4HaHG9FUmOc1CKZ5p77PjKqdKeqq1b9gF2rNlrus /E+3wcVVIXIodnoJCNrZT0IDMtyk2uxVfifvuVH8igqW8DsgM3Iz5nGkFUZtz6/V +uS+eLLhovaMw921ByF24yKhCOPaQK0Xw8OUQGJOWteodD5ZaH64aP+50UncxBnl ZIaL75JTVwTch/JB6ftJy9v2i0fagsXQB3VukDCy3lzUqbebwwLVcqMQRG9nTnDL TfZGAnXZKuLc5PQ/BimBd45APVvLdholvX3t+Qqf9hf1wRANliK7KAnvybbiuKDQ 9TjAHdx6X03/9u69yF4CAlFJGvZFhvwJC+zMuKSvi5mvEmhuXm+fKsWdMQ3YZ3PU gcXnRNFWlCbok/Fb0JraEZ+nRta0uA+Q8bc6aGgk+IcbGFvzyX8pcL99E4JV79+9 FwugpmpqW/d4glE6v9iXFRzuCGBPChhVVISBOvN/MQjC0gCy8f3w9ExrgsBN0dVr GNqNNTxOS4N634u6ItpMQ2fBoOquzUWAI9L0qHRbW7WfOR/AJUs= =/3M8 -----END PGP SIGNATURE----- --Apple-Mail=_ADF92DAC-BFF6-420E-94CD-073B101F6BCA--