From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Daniel =?UTF-8?Q?Mart=C3=ADn?= via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#60555: 29.0.50; Some clarification is needed about "smaller" and "larger" Tree-sitter nodes Date: Wed, 04 Jan 2023 15:29:14 +0100 Message-ID: References: Reply-To: Daniel =?UTF-8?Q?Mart=C3=ADn?= Mime-Version: 1.0 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="22332"; mail-complaints-to="usenet@ciao.gmane.io" To: 60555@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Jan 04 15:30:18 2023 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 1pD4mX-0005bc-2O for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 04 Jan 2023 15:30:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pD4mL-0005kB-63; Wed, 04 Jan 2023 09:30:05 -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 1pD4mJ-0005jz-08 for bug-gnu-emacs@gnu.org; Wed, 04 Jan 2023 09:30: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 1pD4mI-0007fq-Kj for bug-gnu-emacs@gnu.org; Wed, 04 Jan 2023 09:30:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pD4mI-0005PX-A9 for bug-gnu-emacs@gnu.org; Wed, 04 Jan 2023 09:30:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Daniel =?UTF-8?Q?Mart=C3=ADn?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Jan 2023 14:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 60555 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.167284256920732 (code B ref -1); Wed, 04 Jan 2023 14:30:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Jan 2023 14:29:29 +0000 Original-Received: from localhost ([127.0.0.1]:47995 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pD4lk-0005OJ-VU for submit@debbugs.gnu.org; Wed, 04 Jan 2023 09:29:29 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:46094) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pD4lj-0005OB-Fs for submit@debbugs.gnu.org; Wed, 04 Jan 2023 09:29:27 -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 1pD4li-0005ge-V5 for bug-gnu-emacs@gnu.org; Wed, 04 Jan 2023 09:29:27 -0500 Original-Received: from sonic307-54.consmr.mail.ir2.yahoo.com ([87.248.110.31]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pD4lg-0007c2-Gy for bug-gnu-emacs@gnu.org; Wed, 04 Jan 2023 09:29:26 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.es; s=s2048; t=1672842560; bh=u7q9DNVX/u2psmJcqfA16CO9Gd/+XdZO+WwpnZp3cnU=; h=From:To:Subject:Date:References:From:Subject:Reply-To; b=Z0/cOzZZNRYmtOr+2YY1lHgJVLAdEXK5/jocl+UHzEgYDnQgnlIf7nyiOfg9A0mOHuXC5b8XFYZG01Nud/vOgVZ0xeypPn7LT9ykh/t2IkGuFV/vGKHTaCWAc7tw5heG+dj4rJuXwVlk8Iig4O9vaK38odlPcPreSDvXh2yzTTbyaLxc1OdDZGfGYmt7WmKPKoBE70TxPo1OdKDd2nQ4xp/8cn1EwUzvy5s0YIIWy6LLGpEiavx7CRRxVGTRbT9fyusccz4X7JiOHKED/DTAU8kXdljcJYxJRmSQMUuphjOX0JAvSPGD91cpClT2UxAU0DYHQOpbOmudpJKnxv29lQ== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1672842560; bh=O1G2wtxuI8Tjb3WyW4BK3MHKhxgaYk5/EX96KjfIvFE=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=tbpGcZe43w4JYx7IvUxYFns6uPTP8c70o+Qm2xJ+w65Aj4mu34XOVgZ4cjChKN1AvCmdxel6ili5uq17Mk12FJzUK9KH6dzDZc6DIrNc8lVbQ7G8pMG5J0yY8TOX15QZbYZlWhEKIo2t6FI9+ZCuULyq23RwkqQ5ptXvNJeWed3Ff9TMeDjmtKNlmDiJqqnKV12BmPK39pJ7J21FrOPCZ/+T1CV+5JKhGNSGoCo/wXF+3OIE/QijGjA1a/xHQB/aVQgrjBaK5G8wGmof6ZBkyW76OdlK8F0j+mgqETe64EI/9TFKTSj4/ok2RHW5MOJSAVDSURo+cWpCIVhRhtF8ug== X-YMail-OSG: TNdOZXcVM1nV7d1AnISkcx3N3KQJQA2c0P2RWHW8zEs2cUSjxUg9mUJPdZQmsGt KaEjH2o_oWCwokxanNcS3eR1FgZkvSMnplL0HQCFjVnzy_66AwdwabETWp0Gu.eYbmJbp3RNrP3K Vs33PuGZ.roJvPDNotk4uan21iEtFdlchpbeKm5DlkzfcVFq4aJ_7Tunxi34vw.u0wPQgwp6yxF5 ltEAkRz_SgVwH4MRLWQGLsrFVIz.XtO7zrwrfo576zS.A9HL7mDM8SnzHih28VnCnqRkNSVsK_vN _5bRjnYUcaDjAcfzsasqq6xv9r9O.ra9BxIFcvUpKS8VzL7pOUgi84KD3u2Xl6u.deZx6yb8F1io NmDc8NNt5WfPQYrietxh9MSzc5lSfiGsm3PyMDdmdrH38.rBAUi_zVjyKfKyWE6IEOlVo7LLaKO_ qA8ryv4sIBHjoXiLJAmzYYxvIyc96xsUyTAAbR6YamwD1R2jo9bzKZvtg8wIYUeGOiG4lVTKDpIe J6YAi5gjCNiczPFm5MPG0F1Y2F5ycUgqSfR_TrPCPDSgffZ9h.LRRju0G1J3tUCGaGDHoqBPkhBP RDr1_W_X2wvcoiA0jCH6IihBqbJxyi88pkS53.U1pIG8KakVOX8U4yx8qZr1Kyw_E9wMDRd1QMoX xnryfgf12mzuGUoOjBewQhnj3x5h9UTFmOnA6lu7Sa31BjJNmeRhGeTFaRZk_dBfMFMMGaD08WK6 3.qfaTxX0FLnGsUjbuzssBypGDy2ggXQMioFPSvWAxDDbNHdND6UP0u3ed.fpFzrC5u6XEGOOuHa suyK3zMsI0nl4IVUT9DbgmORT8hJUkngnS2wXUXOEM X-Sonic-MF: Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic307.consmr.mail.ir2.yahoo.com with HTTP; Wed, 4 Jan 2023 14:29:20 +0000 Original-Received: by hermes--production-ir2-5795fc58c8-6s895 (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID e45fef4bf9402892b06845bf44c2112e; Wed, 04 Jan 2023 14:29:15 +0000 (UTC) X-Mailer: WebService/1.1.20982 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=87.248.110.31; envelope-from=mardani29@yahoo.es; helo=sonic307-54.consmr.mail.ir2.yahoo.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 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_ENVFROM_END_DIGIT=0.25, 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: 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:252476 Archived-At: In the Elisp manual, under "37.3 Retrieving Nodes" there is this text: We talk about a node being =E2=80=9Csmaller=E2=80=9D or =E2=80=9Clarger= =E2=80=9D, and =E2=80=9Clower=E2=80=9D or =E2=80=9Chigher=E2=80=9D. A smaller and lower node is lower in the syntax = tree and therefore spans a smaller portion of buffer text; a larger and higher node is higher up in the syntax tree, it contains many smaller nodes as its children, and therefore spans a larger portion of text. I think the concepts of nodes being "lower" and "higher" are more or less clear, and the notation is similar to the one used in classic texts about rooted trees. However, the concepts of "smaller" and "larger" are not very clear to me. From the text, it seems that "lower" also means "smaller", and "higher" always means "larger". Is that correct, or "smaller" and "larger" are really orthogonal to "lower" and "higher"? If that's the case, I think the text needs some clarification, ideally with a brief example. Thanks.