emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation for car and cdr


From: Lennart Borgman
Subject: Re: Documentation for car and cdr
Date: Wed, 25 Jan 2006 22:44:05 +0100
User-agent: Thunderbird 1.5 (Windows/20051201)

Alan Mackenzie wrote:
What does this doc-string say to the novice lisp programmer?  It says
"We're telling you that the function called \"cdr\" actually returns the
abstract \"cdr\" of a lisp object, just in case that isn't obvious."  It
goes on, implicitly by omission, to say "if you really don't know what a
cdr is by this stage, you're so stupid that there's no point in us
bothering to tell you."
...
I suggest making this doc-string more helpful by appending the following
to it:

"Loosely speaking, the cdr of LIST is LIST without its first element."
This is a very good idea since the beginner might remember that one of the gives the first (or was it last?) element and the other gives the rest.

Giving a link to the info node is of course also very good.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]