From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#6591: 24.0.50; incorrect doc for `catch' Date: Sun, 11 Jul 2010 09:52:35 -0700 Message-ID: <526FD0D227F74C5EB38D8F5B903749E1@us.oracle.com> References: <831vbcbl7n.fsf@gnu.org><5500EFEE9A854408ABF0FE400497FE2D@us.oracle.com><83tyo7aiay.fsf@gnu.org><83mxtz9zbn.fsf@gnu.org><3ACAED77613643B7B2FC0207DDE11F11@us.oracle.com><83y6djuyah.fsf@gnu.org><38AC360676154EFF8DF9F35945B6EFAE@us.oracle.com><83sk3qv922.fsf@gnu.org> <87lj9infkq.fsf@stupidchicken.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1278867616 31328 80.91.229.12 (11 Jul 2010 17:00:16 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 11 Jul 2010 17:00:16 +0000 (UTC) Cc: 6591@debbugs.gnu.org, 'Richard Stallman' To: "'Chong Yidong'" , "'Eli Zaretskii'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 11 19:00:15 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OXzt0-00024X-Pg for geb-bug-gnu-emacs@m.gmane.org; Sun, 11 Jul 2010 19:00:15 +0200 Original-Received: from localhost ([127.0.0.1]:46718 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OXzt0-0007Ff-6I for geb-bug-gnu-emacs@m.gmane.org; Sun, 11 Jul 2010 13:00:14 -0400 Original-Received: from [140.186.70.92] (port=40709 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OXzsu-0007FV-KM for bug-gnu-emacs@gnu.org; Sun, 11 Jul 2010 13:00:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OXzst-0007Fh-JC for bug-gnu-emacs@gnu.org; Sun, 11 Jul 2010 13:00:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:55396) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OXzst-0007Fc-CE for bug-gnu-emacs@gnu.org; Sun, 11 Jul 2010 13:00:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OXzmz-0005CC-SC; Sun, 11 Jul 2010 12:54:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 11 Jul 2010 16:54:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6591 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 6591-submit@debbugs.gnu.org id=B6591.127886721819963 (code B ref 6591); Sun, 11 Jul 2010 16:54:01 +0000 Original-Received: (at 6591) by debbugs.gnu.org; 11 Jul 2010 16:53:38 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OXzmb-0005Bw-JU for submit@debbugs.gnu.org; Sun, 11 Jul 2010 12:53:37 -0400 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OXzma-0005Bm-Db for 6591@debbugs.gnu.org; Sun, 11 Jul 2010 12:53:37 -0400 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id o6BGrY2K028537 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 11 Jul 2010 16:53:36 GMT Original-Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o6BEEw1g028588; Sun, 11 Jul 2010 16:53:34 GMT Original-Received: from abhmt001.oracle.com by acsmt355.oracle.com with ESMTP id 395623711278867154; Sun, 11 Jul 2010 09:52:34 -0700 Original-Received: from dradamslap1 (/10.175.255.126) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 11 Jul 2010 09:52:34 -0700 X-Mailer: Microsoft Office Outlook 11 In-reply-to: <87lj9infkq.fsf@stupidchicken.com> Thread-Index: AcshFtgs4U/ToXFlRgCFmNMZs68J7wAAMwpw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5931 X-Source-IP: acsmt353.oracle.com [141.146.40.153] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090203.4C39F70E.015E:SCFMA4539814,ss=1,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 11 Jul 2010 12:54:01 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:38392 Archived-At: > The dots are important, because BODY normally implies one single form. > We are somewhat abusing notation by using `BODY...' to denote one or > more forms, but the convention is well-established and easy to grasp, > and there are no better alternatives. No better alternative? Did you read the thread? What about doing what the rest of the world does: (catch TAG FORM...)? Then if you really need to talk about the "body" for some reason, just say that the body is everything that follows TAG or it is the collection of forms or some such. No need to use "body" in the syntax description. (And no real need to even mention the body.) > I suggest doing everywhere what the `progn' documentation does, and > refer to BODY as "BODY forms". > > (progn BODY...) > Eval BODY forms sequentially and return value of last one. Same problem - see the start of the thread. What does "BODY forms" refer to: (1) a set of BODYs, each of which is a Lisp form, or (2) the set of Lisp forms that comprise a BODY. The term "BODY forms" is ambiguous. It can mean the forms that make up BODY or a list of forms each of which is a BODY. And what does `...' signify here: repetition of what it follows (i.e. repetition of BODY), as in the rest of the world, or a special Emacs-only syntax where `BODY...' is taken as a single token that is replaced by splicing in a list of Lisp forms? (progn FORM...) is much clearer. Users can parse it in the usual way: FORM is replaceable by a Lisp form, and `FORM...' simply means a repetition of Lisp forms.