From: "Drew Adams" <drew.adams@oracle.com>
To: "'Eli Zaretskii'" <eliz@gnu.org>
Cc: 6591@debbugs.gnu.org
Subject: bug#6591: 24.0.50; incorrect doc for `catch'
Date: Sat, 10 Jul 2010 08:44:47 -0700 [thread overview]
Message-ID: <3ACAED77613643B7B2FC0207DDE11F11@us.oracle.com> (raw)
In-Reply-To: <83mxtz9zbn.fsf@gnu.org>
> > Ah! Then the syntax should be (catch TAG . BODY) or similar.
> ^^^
> Why the period?
Same reason as your special `BODY...' syntax. It means _splice in_ the list
BODY. Or if you like, it means that BODY is the cdr of the sexp as a list. Or
if you like, it is equivalent to ,@BODY in backquote syntax.
You cannot write just (catch TAG BODY). There must be some indication (`.',
`...' or other) to distinguish normal substitution for a placeholder from
splicing substitution for a placeholder. Substitution for TAG is treated
differently from substitution for BODY.
But are you just playing/kidding here? or arguing? What's the point? I'm sure
that you understand the syntax (A . B) in Lisp and in our docs. I assume you
are trying to make some point, but I fail to see it.
Perhaps you simply want to hint that (A B...) is a notation that means the same
thing as (A . B). If so, fine.
However:
1. I do not think the `...' syntax is described/defined anywhere in the doc.
2. More importantly (since it is anyway easy to miss such a definition), `...'
has a different meaning typically/commonly, so our interpretation (syntax
convention) of `...' can easily mislead and confuse. Readers will tend to think
that BODY... means zero (or one) or more repetitions of BODY. (Which is just
what I originally thought it was trying to say.)
So the syntax descriptors for catch, let, and progn are NOT incorrect, after
all. It is the syntax convention that we've chosen that is misleading. We are
entitled to any convention we like, as long as it is rigorous and we use it
consistently (which I'm not questioning now). But it make sense not to use a
convention that can be easily mistaken for a different convention that is more
commonly used. `...' commonly means repetition of whatever it follows, and
there is no repetition of BODY here (there is only one body).
You decide.
next prev parent reply other threads:[~2010-07-10 15:44 UTC|newest]
Thread overview: 51+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-07-09 15:52 bug#6591: 24.0.50; incorrect doc for `catch' Drew Adams
2010-07-09 17:48 ` Eli Zaretskii
2010-07-09 19:36 ` Drew Adams
2010-07-10 7:48 ` Eli Zaretskii
2010-07-10 14:14 ` Drew Adams
2010-07-10 14:38 ` Eli Zaretskii
2010-07-10 15:44 ` Drew Adams [this message]
2010-07-10 15:55 ` Eli Zaretskii
2010-07-11 4:21 ` Drew Adams
2010-07-11 6:15 ` Eli Zaretskii
2010-07-11 8:14 ` Štěpán Němec
2010-07-11 9:22 ` Eli Zaretskii
2010-07-11 10:59 ` Štěpán Němec
2010-07-11 13:23 ` Eli Zaretskii
2010-07-11 13:44 ` Štěpán Němec
2010-07-11 14:00 ` Eli Zaretskii
2010-07-11 15:26 ` Andreas Schwab
2010-07-11 15:33 ` Drew Adams
2010-07-11 17:22 ` Eli Zaretskii
[not found] ` <mailman.11.1278862210.6344.bug-gnu-emacs@gnu.org>
2010-07-11 22:36 ` Tim X
[not found] ` <mailman.2.1278856813.6344.bug-gnu-emacs@gnu.org>
2010-07-11 22:34 ` Tim X
2010-12-08 15:52 ` Drew Adams
2010-12-20 12:25 ` Chong Yidong
2010-07-11 15:33 ` Drew Adams
2010-07-11 17:25 ` Eli Zaretskii
2010-07-11 16:33 ` Chong Yidong
2010-07-11 16:52 ` Drew Adams
2010-07-11 17:13 ` Chong Yidong
2010-07-11 17:58 ` Drew Adams
2010-07-11 18:14 ` Andreas Schwab
2010-07-11 19:10 ` Drew Adams
2010-07-11 19:40 ` Andreas Schwab
2010-07-11 20:07 ` Drew Adams
2010-07-11 21:22 ` Andreas Schwab
2010-07-11 21:42 ` Chong Yidong
2010-07-11 21:44 ` Drew Adams
2010-07-12 8:43 ` Andreas Schwab
2010-07-12 14:56 ` Drew Adams
2010-07-12 15:26 ` Andreas Schwab
2010-07-12 16:01 ` Drew Adams
2010-07-12 16:11 ` Andreas Schwab
2010-07-12 16:31 ` Drew Adams
2010-07-12 16:36 ` Andreas Schwab
2010-07-12 16:50 ` Drew Adams
2010-07-12 18:14 ` Andreas Schwab
2010-07-12 18:35 ` Drew Adams
2010-07-12 18:41 ` Andreas Schwab
2010-07-12 18:49 ` Drew Adams
2010-07-12 17:02 ` Eli Zaretskii
2010-07-12 18:30 ` Drew Adams
2010-07-10 5:44 ` MON KEY
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=3ACAED77613643B7B2FC0207DDE11F11@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=6591@debbugs.gnu.org \
--cc=eliz@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.