From: "Drew Adams" <drew.adams@oracle.com>
To: <emacs-pretest-bug@gnu.org>
Subject: bug#1381: 23.0.60; capitalization of car and cdr in the doc
Date: Wed, 19 Nov 2008 10:22:25 -0800 [thread overview]
Message-ID: <000a01c94a73$c5bd1ed0$c2b22382@us.oracle.com> (raw)
See for example these nodes of the Elisp manual: Cons Cell Type,
Search-based Fontification (which should be called Search-Based
Fontification, BTW).
I'd suggest not making CAR and CDR uppercase. There is no need to do
that; they are normal words of our vocabulary: speaking about "the
cdr" is no different from speaking about "the cons" ("the cons
cell").
The first time these terms are introduced (defined), then whatever
convention (quotation marks, uppercase, italic - whatever it is) we
normally use to introduce new terms should be followed, of course.
But thereafter we should just write about conses, cars, and cdrs,
using no special typography. Not CONSes, CARs, and CDRs, and not
CONSES, CARS, and CDRS.
Especially in a context, such as node Search-Based Fontification,
where uppercase means something different, treating "car" and "cdr" as
"CAR" and "CDR" is confusing:
`(MATCHER . SUBEXP)'
In this kind of element, MATCHER is either a regular expression or
a function, as described above. The CDR, SUBEXP, specifies which
subexpression of MATCHER should be highlighted (instead of the
entire text that MATCHER matched).
We wouldn't write "the CDR of the CONS". "the CDR of the cons" is no
more appropriate. It's clearest to write "the car of the cons".
Also, if we don't already do so (I didn't find it), then we should
mention (e.g. in node Cons Cell Type) that "cons" is sometimes used as
short for "cons cell": a cons is a cons cell. That will improve
readability. The alternative of mentioning this is to make sure that
we use "cons cell" each time.
Naturally, whatever convention we use generally for Emacs vocabulary
should be used for "car" and "cdr" too. I'm not sure what it is, but
I know we don't use uppercase systematically for Emacs terminology:
"The BUFFER displayed in the top WINDOW of the selected FRAME...".
Similarly: "This cons, whose cdr is 42, has the symbol `foo' as its
car", not "This CONS, whose CDR is 42, has the SYMBOL `foo' as its
CAR".
Car 54, where are you?
Caveat: I'm looking at the doc in Info (in Emacs). I have no idea how
these terms appear in print.
In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
of 2008-11-08 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include
-fno-crossjumping'
next reply other threads:[~2008-11-19 18:22 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <87r5jw5ly6.fsf@stupidchicken.com>
2008-11-19 18:22 ` Drew Adams [this message]
2008-11-19 19:34 ` bug#1381: 23.0.60; capitalization of car and cdr in the doc Eli Zaretskii
2008-11-19 19:46 ` Drew Adams
2008-11-19 20:05 ` Eli Zaretskii
2008-11-20 14:26 ` Richard M. Stallman
2008-11-20 16:22 ` Drew Adams
2008-11-21 15:17 ` Richard M. Stallman
2008-11-21 16:17 ` Drew Adams
2008-11-20 20:23 ` Eli Zaretskii
2008-11-20 20:28 ` Drew Adams
2008-11-20 20:43 ` Eli Zaretskii
2008-11-20 20:57 ` Drew Adams
2008-11-21 7:44 ` Yavor Doganov
2008-11-21 15:28 ` Drew Adams
[not found] ` <handler.1381.C.127740381719306.notifdonectrl.7@debbugs.gnu.org>
2010-06-24 18:39 ` bug#1381: acknowledged by developer (close 1382) Drew Adams
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='000a01c94a73$c5bd1ed0$c2b22382@us.oracle.com' \
--to=drew.adams@oracle.com \
--cc=1381@emacsbugs.donarmstrong.com \
--cc=emacs-pretest-bug@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.