GNU bug report logs - #6591
24.0.50; incorrect doc for `catch'

Previous Next

Full log

View this message in rfc822 format

From: Chong Yidong <cyd <at> stupidchicken.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 6591 <at> debbugs.gnu.org, Richard Stallman <rms <at> gnu.org>, Drew Adams <drew.adams <at> oracle.com>
Subject: bug#6591: 24.0.50; incorrect doc for `catch'
Date: Sun, 11 Jul 2010 12:33:41 -0400

Eli Zaretskii <eliz <at> gnu.org> writes:

> Using FORM... is okay, but will need more extensive changes, so I'd
> rather not do it.  I'd like to simply remove the dots after BODY, and
> explain in the text that BODY can consist of one or more forms.
>
> Does anyone see any reason why keeping the dots in BODY... will have
> some didactical importance?  Richard? Stefan? Yidong?

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.

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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.