From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.bugs Subject: bug#34842: 26.1; Alist documentation: let-alist Date: Sun, 13 Oct 2019 13:38:09 +0100 Message-ID: <87lftohlce.fsf@tcd.ie> References: <87eezhh763.fsf@gnus.org> <871rvh9zc4.fsf@tcd.ie> <87a7a5e4yc.fsf@gnus.org> <83wod9kten.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="216426"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Lars Ingebrigtsen , 34842@debbugs.gnu.org, seb.hoagie@outlook.com To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 13 14:40:24 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJdAe-000uB0-1K for geb-bug-gnu-emacs@m.gmane.org; Sun, 13 Oct 2019 14:40:24 +0200 Original-Received: from localhost ([::1]:39332 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iJdAc-00013H-8O for geb-bug-gnu-emacs@m.gmane.org; Sun, 13 Oct 2019 08:40:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39917) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iJdAN-00012v-R0 for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:40:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iJd9K-0001zV-ON for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:39:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54742) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iJd9K-0001zN-Kn for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:39:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iJd9K-0006GT-Gm for bug-gnu-emacs@gnu.org; Sun, 13 Oct 2019 08:39:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 13 Oct 2019 12:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34842 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 34842-submit@debbugs.gnu.org id=B34842.157097030424034 (code B ref 34842); Sun, 13 Oct 2019 12:39:02 +0000 Original-Received: (at 34842) by debbugs.gnu.org; 13 Oct 2019 12:38:24 +0000 Original-Received: from localhost ([127.0.0.1]:35330 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJd8h-0006Fa-Vm for submit@debbugs.gnu.org; Sun, 13 Oct 2019 08:38:24 -0400 Original-Received: from mail-wm1-f42.google.com ([209.85.128.42]:36455) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJd8f-0006FN-I0 for 34842@debbugs.gnu.org; Sun, 13 Oct 2019 08:38:22 -0400 Original-Received: by mail-wm1-f42.google.com with SMTP id m18so14144115wmc.1 for <34842@debbugs.gnu.org>; Sun, 13 Oct 2019 05:38:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=vXKxijZ//z+CowVkP4xrPwBrklwi2EcjuM2cPCXfTSI=; b=gpMtLgp7d+LFCBtNq38ERK5GSlgPb1yWGE64fOfMcMAgMlvrTvYTluqnX17bV07/8d kNHwpEcFXhZsrkiLfrCsrgI7XwvtRPRf5l0Uq5egxWExEeyw8QTLvqiAeSN5xI0BWmb0 L/66794/OKKO5y3KscjOl2wj6A6YY0ymRwE6ikulFTOkw+L5twj3nyqvmjuddNCqqc9u eO6Fov30Fi1Y1ChnDdsgb0gxdbEXgxgBqqas+a2vTDJ3o/eWQVIM3zPi0XdeIm+H2DJN oMQ9ul8/M1O9w1WBiwlClnhSSUGyT7lSMBrbpiR8LXsrlyxbMSYe3SmjWZ7Jzls2pE3o j1zA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=vXKxijZ//z+CowVkP4xrPwBrklwi2EcjuM2cPCXfTSI=; b=POUzSWhEoQksXu0dpsAVIiycaiebkTr4KsKU9fO3Zc3aumYVT47Rwj7v90e60SWXW6 +N9nlBYaIt7lqZ8z0Sr5QxLA5XNi9u4VRC0NtOXtiuEvGsXjXJV79LFPhZEt9s4nOGgo QjjPF64kuzitf195HqJBkOW78hVhK8snOg+lANZweWLVlpuUy50gKp4dPjUH3fDaDUxs /I2A7R61LHJk9xzqIQyBcBtzPqHIQaSJPZg+JJrHi2Nl/IOhQm4UQxjAxxwbhGaMnSfJ xXBeYy5mGw+uZb+6exGuEF+Qiz7lzDLnTu7S4w2KdjM4jcbllcE8B8XrI1ylxQ4j3t7l PSQA== X-Gm-Message-State: APjAAAUrwf/vDAGp5V17gFLAGTq+q6U6v1y7pp6MN+sKC0k39Stzg6q3 tiTBCTz3uMdkkkAiVo/vC3Q+3Q== X-Google-Smtp-Source: APXvYqzFaqErmAEJtO5BWWd80lZg7Xu5wJHKD9rsAzhfOgG2pvOw4AHiMPT2e9nRdYmC5Uf14uhtRQ== X-Received: by 2002:a05:600c:28d:: with SMTP id 13mr11664528wmk.100.1570970295526; Sun, 13 Oct 2019 05:38:15 -0700 (PDT) Original-Received: from localhost ([2a02:8084:20e2:c380:1f68:7ff5:120d:64e]) by smtp.gmail.com with ESMTPSA id h14sm19759246wro.44.2019.10.13.05.38.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Oct 2019 05:38:14 -0700 (PDT) In-Reply-To: <83wod9kten.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 13 Oct 2019 10:15:44 +0300") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:169115 Archived-At: Eli Zaretskii writes: >> From: Lars Ingebrigtsen >> Date: Sun, 13 Oct 2019 04:48:11 +0200 >> Cc: 34842@debbugs.gnu.org, Sebasti=C3=A1n Mon=C3=ADa >> >>=20 >> "Basil L. Contovounesios" writes: >>=20 >> > Thanks. The following constitute what I think are some opportunities >> > for clarifying the current doc. WDYT? >>=20 >> Looks good to me, but: > > I have one more nit: why was @dots{} added after @var{body} in the > @defmac line? There's only one body here, isn't it? There's only one body indeed, but it comprises multiple forms. The Elisp manual currently contains over 50 occurrences of body..., including the following: -- Macro: dolist (var list [result]) body... -- Special Form: catch tag body... -- Macro: ignore-errors body... -- Macro: defun name args [doc] [declare] [interactive] body... -- Macro: lambda args [doc] [interactive] body... -- Macro: defsubst name args [doc] [declare] [interactive] body...=20=20= =20=20=20 -- Macro: defmacro name args [doc] [declare] body... -- Macro: with-eval-after-load library body... -- Special Form: eval-when-compile body... Whereas it only contains 7 occurrences of '&rest body': -- Macro: pcase-defmacro name args [doc] &rest body -- Macro: with-connection-local-variables &rest body -- Macro: gv-define-setter name arglist &rest body -- Macro: gv-letplace (getter setter) place &rest body -- Macro: minibuffer-with-setup-hook function &rest body -- Macro: with-coding-priority coding-systems &rest body... -- Macro: with-temp-message message &rest body [Note that with-coding-priority uses both &rest and body...] And let-alist is the only occurrence of a body without either &rest or an ellipsis: -- Macro: let-alist alist body Of course there is also the forms... style, of which there are under 20 occurrences, including: -- Special Form: progn forms... -- Special Form: if condition then-form else-forms... -- Macro: when condition then-forms... -- Macro: unless condition forms... -- Special Form: while condition forms... -- Special Form: let (bindings...) forms... I don't mind which style is preferred, but let-alist should probably pick one of the existing ones, right? Any preference? Thanks, --=20 Basil