From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Tim X Newsgroups: gmane.emacs.bugs Subject: Re: bug#6591: 24.0.50; incorrect doc for `catch' Date: Mon, 12 Jul 2010 08:34:21 +1000 Organization: Rapt Technologies Message-ID: <87y6dhabrm.fsf@lion.rapttech.com.au> 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> <877hl2a0zs.fsf@gmail.com> <83lj9iv0dg.fsf@gnu.org> <8739vq9td1.fsf@gmail.com> <83iq4mup8h.fsf@gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1291820605 17508 80.91.229.12 (8 Dec 2010 15:03:25 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 8 Dec 2010 15:03:25 +0000 (UTC) To: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 08 16:03:20 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 1PQLY5-0005dN-Ix for geb-bug-gnu-emacs@m.gmane.org; Wed, 08 Dec 2010 16:03:17 +0100 Original-Received: from localhost ([127.0.0.1]:37004 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PQLY5-00007g-3R for geb-bug-gnu-emacs@m.gmane.org; Wed, 08 Dec 2010 10:03:17 -0500 Original-Path: usenet.stanford.edu!news.glorb.com!news2.glorb.com!news-xfer.nntp.sonic.net!news.alt.net!news.astraweb.com!border5.newsrouter.astraweb.com!not-for-mail Original-Newsgroups: gnu.emacs.bug User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.2 (gnu/linux) Cancel-Lock: sha1:HJ6pZw5SuMB6uT0K2ghH9rcSLto= Original-Lines: 56 Original-NNTP-Posting-Host: 25f238ff.news.astraweb.com Original-X-Trace: DXC=n5?Xe>B=nhcfMO9kN]`\TcL?0kYOcDh@jW\:Hm@YlDbj7; AA>@4l?Mf4QaQ<_l@0UfV2:oXXaG`8c Original-Xref: usenet.stanford.edu gnu.emacs.bug:65752 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list 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:42299 Archived-At: Štěpán Němec writes: > Eli Zaretskii writes: > >>> From: Štěpán Němec >>> Cc: 6591@debbugs.gnu.org, rms@gnu.org >>> Date: Sun, 11 Jul 2010 12:59:38 +0200 >>> >>> >> Well, just look at `when' -- ISTM it has the very same "problem" as >>> >> discussed here. And it's probably not the only one/two. >>> > >>> > Sorry, I don't get your point. Sure, there are places in the manual >>> > that use "FORM...", but that doesn't necessarily mean it's the only >>> > possible way of describing that. "BODY..." is used in quite a few >>> > places as well, and I was only talking about those. >>> >>> You were asking about BODY... >>> `when' uses BODY..., and IMO in `when' `BODY...' means the very same >>> thing as in `catch' (i.e., "any number of forms"), which you're now >>> apparently about to change. >> >> I think you are using an old version of the ELisp manual. The latest >> one on the trunk doesn't use BODY... That's why I misunderstood your >> point. > > (describe-function 'when) > >> But yes, I know that `catch' is not the only one that uses BODY... and >> I intended to change them all. > > I just hope you're not going to change them to `BODY' instead of > `BODY...', as that would mean > > (when (condition) > (a single form)) > > `FORM...' would seem more clear, but I don't really care that much. > > But I thought that was what the discussion was about i.e. BODY == FORM..... but BODY... is equal to multiple 'bodies' which is not what is meant. I prefer BODY rather than BODY..., but think the CL FORM* is the clearer when you want to indicate one or more forms. Tim -- tcross (at) rapttech dot com dot au