From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#60555: 29.0.50; Some clarification is needed about "smaller" and "larger" Tree-sitter nodes Date: Thu, 05 Jan 2023 08:24:07 +0200 Message-ID: <83lemhxzw8.fsf@gnu.org> References: <83cz7uz6rl.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="17763"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 60555@debbugs.gnu.org To: Daniel =?UTF-8?Q?Mart=C3=ADn?= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 05 07:24:26 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 1pDJft-0004Rn-BA for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 05 Jan 2023 07:24:25 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pDJfY-0002tf-Ot; Thu, 05 Jan 2023 01:24: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 1pDJfW-0002tC-O8 for bug-gnu-emacs@gnu.org; Thu, 05 Jan 2023 01:24:02 -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 1pDJfW-000172-95 for bug-gnu-emacs@gnu.org; Thu, 05 Jan 2023 01:24:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pDJfV-0005OX-MZ for bug-gnu-emacs@gnu.org; Thu, 05 Jan 2023 01:24:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 05 Jan 2023 06:24:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60555 X-GNU-PR-Package: emacs Original-Received: via spool by 60555-submit@debbugs.gnu.org id=B60555.167289984020729 (code B ref 60555); Thu, 05 Jan 2023 06:24:01 +0000 Original-Received: (at 60555) by debbugs.gnu.org; 5 Jan 2023 06:24:00 +0000 Original-Received: from localhost ([127.0.0.1]:50053 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pDJfU-0005OH-79 for submit@debbugs.gnu.org; Thu, 05 Jan 2023 01:24:00 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:39596) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pDJfS-0005O3-UM for 60555@debbugs.gnu.org; Thu, 05 Jan 2023 01:23:59 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pDJfN-00016S-Ig; Thu, 05 Jan 2023 01:23:53 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=+pFwm31u9Ued0wQJEU+olTMiP1PjUqxoVWFAY1byzA0=; b=lNXDzgZRHuJjM6EsUNYb b1AhiP1nE11NgdeFkFO4us7di3QGOg96vpiUNdNL160KDFtpm7PwaYlZ3fAc141XcXO2CQDWi1Fbk 5P8P6hbr7tbvPS4VWgIndg1dJqRUaYIdvUNyZkLcX4xERRnW3rCDlQbZILITXcZETRehXkggtciQo 6ZMCzpFG6k87/dvvuBzOjuIgCIqLJOQjFem4yyXcIp+bfRl6XR8IQBlkPHI7gjcCbauvmOHS6zcA9 Qjh0ONboivbcaYNG4Z6yam20sLIfzry8I/3p90JNXv+PJeQYC1+jfb2AqKcDZa3Ii026V7imVekZQ PylVUQUCBTLYcg==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pDJfN-0004BI-0M; Thu, 05 Jan 2023 01:23:53 -0500 In-Reply-To: (message from Daniel =?UTF-8?Q?Mart=C3=ADn?= on Thu, 05 Jan 2023 00:05:43 +0100) 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:252554 Archived-At: > From: Daniel Martín > Cc: 60555@debbugs.gnu.org > Date: Thu, 05 Jan 2023 00:05:43 +0100 > > Eli Zaretskii writes: > > > They aren't orthogonal, AFAIU. The text actually says that "lower" > > necessarily also means "smaller". > > If that's the case, I don't feel the text is clear enough about the > "necessarily" part. I think the text would be more clear if the first > sentence was > > We talk about a node being “smaller” (or "lower") and “larger” (or > “higher”). Adding parentheses makes the text harder to read, IME. You kept all the words and the sentence structure, so everything else is unchanged, and the added complexity isn't justified, IMO. > The next sentence should avoid "smaller and lower" and "larger and > higher", because it'd be redundant (can a node be "smaller and > higher"?). That is, I suggest the following text instead: > > A smaller node is lower in the syntax tree and therefore spans a > smaller portion of buffer text; a larger 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 these micro-changes are basically splitting hair, and the text you propose will almost certainly be less clear for someone. If the original text is unclear, the way to fix that is to rewrite it in a completely different way. If you try explaining what exactly confuses you, maybe I could come up with such a rewrite. I cannot myself understand what's unclear, because to me it sounds very clear and simple to understand. So I need your help. Try to recollect what confused you when you first read this.