From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Xiyue Deng Newsgroups: gmane.emacs.bugs Subject: bug#67820: 29.1; Code example in "fwd-para while" has unmatched ending parentheses Date: Fri, 15 Dec 2023 14:08:51 -0800 Message-ID: <87cyv7jez0.fsf@debian-hx90.lan> References: <875y119vkk.fsf@debian-hx90.lan> <83wmtfoade.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37811"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 67820@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Dec 15 23:09:23 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 1rEGN0-0009aG-Qh for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 15 Dec 2023 23:09:22 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rEGMi-0005IE-Db; Fri, 15 Dec 2023 17:09: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 1rEGMh-0005Hz-6N for bug-gnu-emacs@gnu.org; Fri, 15 Dec 2023 17:09:03 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rEGMg-000667-Un for bug-gnu-emacs@gnu.org; Fri, 15 Dec 2023 17:09:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rEGMg-00077C-R9 for bug-gnu-emacs@gnu.org; Fri, 15 Dec 2023 17:09:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Xiyue Deng Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 15 Dec 2023 22:09:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 67820 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: pending patch Original-Received: via spool by 67820-submit@debbugs.gnu.org id=B67820.170267814127339 (code B ref 67820); Fri, 15 Dec 2023 22:09:02 +0000 Original-Received: (at 67820) by debbugs.gnu.org; 15 Dec 2023 22:09:01 +0000 Original-Received: from localhost ([127.0.0.1]:53712 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rEGMe-00076t-Re for submit@debbugs.gnu.org; Fri, 15 Dec 2023 17:09:01 -0500 Original-Received: from mail-pg1-x52d.google.com ([2607:f8b0:4864:20::52d]:61619) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rEGMd-00076X-0b for 67820@debbugs.gnu.org; Fri, 15 Dec 2023 17:08:59 -0500 Original-Received: by mail-pg1-x52d.google.com with SMTP id 41be03b00d2f7-53fa455cd94so689419a12.2 for <67820@debbugs.gnu.org>; Fri, 15 Dec 2023 14:08:58 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1702678133; x=1703282933; darn=debbugs.gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=zaEBORD+ggUl9i1tD49TcfPsMV+pvOELpuUOe5flXrM=; b=OffBvN2pR6fhUGYUeIntjqaisiN9MwGkZ392XnmCzzdYH13DnPi/HdzZLrvyeDXEOQ Jb+sEZQo4IbiO8yKTfvxLYd7A0ROIgrFns/qsOShzuoJ55yULPqfcWtUPq6oLqMoH1jE SY+2CneYam6udTVOAhgFphtt8TTbyO1yFfU2W13AIe053VQvz1U7Q7CojEbeU3gjs5kM EWWsgMVfkNkftd1qSwzzH4zpcde8hsWx/OTP9UV8S9h7T48xjuc7+0i2nzcxu1ZpTusw /kQo7Z8XFLBAgvnruAmCkGN4FkqGKXsH1UcA10YXXoQnscNsc3qcj17mhFP1RGW57SrU lNrA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702678133; x=1703282933; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=zaEBORD+ggUl9i1tD49TcfPsMV+pvOELpuUOe5flXrM=; b=urHCd99wcp/8ufgyhl3SvBbh++HRX3yHaih3Dm7Rds4XqxXPWPEGLiZcuMESqr7M+v S6W9C32hFEZlsP8wXzCMOrmYE64dpsMvVMDdm5rlIaFn7WUoTmMoaRkLeXTo0L14wOcb mU1H/nCkLyID1Wsh535NCFSOLs4vXYfr7F40HyTSTB5J69+oLCL5Cs/QIabgQopbKPmY B0Il6YctQ+auoWCjTnhA+KIYwdwVY2xkn1QrBMpiuK+rCrUzu7mRVWsDTuB7fxK9kv8m 4THtDYTa94D2VgV77zgVwD8A+Vr2Ny1gCDlLcP2/FQtZXcrSPe7lRRCwGEIG47TNd7Ad iANA== X-Gm-Message-State: AOJu0Yzl+fkzd3KLwhV32PfoNwwT4wNwoMskpAUoWm9iwZkrH3KtS1CC I/iSRTxVRGbiL1DpRv+qqkLbN4IYnK4= X-Google-Smtp-Source: AGHT+IFND++7JbbhvJS7DB8slHNySjlhsAfcbqWDC/kDSmV3dXyWI4KwhELKMGi7+7bjx8NzpE0AKA== X-Received: by 2002:a05:6a20:3d29:b0:18f:ff44:87ee with SMTP id y41-20020a056a203d2900b0018fff4487eemr8626682pzi.49.1702678132532; Fri, 15 Dec 2023 14:08:52 -0800 (PST) Original-Received: from debian-hx90 (2603-8000-a400-0cdc-8498-b219-dc0f-ac83.res6.spectrum.com. [2603:8000:a400:cdc:8498:b219:dc0f:ac83]) by smtp.gmail.com with ESMTPSA id kb1-20020a17090ae7c100b00286e9bec1efsm16755173pjb.33.2023.12.15.14.08.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Dec 2023 14:08:52 -0800 (PST) In-Reply-To: <83wmtfoade.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 15 Dec 2023 15:37:01 +0200") 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:276291 Archived-At: Eli Zaretskii writes: >> From: Xiyue Deng >> Date: Wed, 13 Dec 2023 21:55:55 -0800 >> >> >> The code example in section "fwd-para while" has unmatched ending >> parentheses[1]. Admittedly this code snippet was copied literally from >> the previous longer code sample where the 2 extra ending parentheses >> were to match the `if' and `while', but it would make more sense to drop >> them in this example. Will add a patch next. > > I'm not sure it makes sense to make this expression stand-alone. As > you say, this snippet is copied verbatim from the full example at the > beginning of the section. So I think we should leave this alone. > > Thanks. This essentially was due to the coding convention to put all ending parentheses on the last line of the sexp, which most other programming languages don't normally share. But anyway. Just want to say that a code snippet with unmatched ending parentheses would confuse beginners a little. However, if from a book writing point of view that code snippets should be copied literally, it's probably understandable (adding a small explanation for the extras would better still, and I can update the patch accordingly.) Wdyt? -- Xiyue Deng