all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
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'
 







             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.