[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Documentation for car and cdr
From: |
Thien-Thi Nguyen |
Subject: |
Re: Documentation for car and cdr |
Date: |
25 Jan 2006 17:07:02 -0500 |
User-agent: |
Gnus/5.09 (Gnus v5.9.0) Emacs/21.4 |
Alan Mackenzie <address@hidden> writes:
> Each of these sentences is completely accurate (by virtue of "loosely
> speaking"), regardless of whether LIST is a list, a dotted pair, or
> nil.
blech. placing "loosely speaking" in the docstring decreases
credibility (take it from a practiced word weasler: those are weasel
words), and does not clarify anything. that's certainly a bad move.
(note: CERTAINLY, not just LOOSELY SPEAKING.)
this whole thread is populated by people who know what CAR and CDR are.
people who don't, who *might* be confused, who *may* be offended by such
crass self-documentation; they won't read this or the docstring anyway!
now, i suppose someone will lark an ostensibly non-expert friend into
sending a bug report on this. what, is it 1-april already?
thi
- Re: Documentation for car and cdr, (continued)
- Re: Documentation for car and cdr, David Kastrup, 2006/01/25
- Re: Documentation for car and cdr, Thien-Thi Nguyen, 2006/01/25
- Re: Documentation for car and cdr, Lennart Borgman, 2006/01/25
- Re: Documentation for car and cdr, Thien-Thi Nguyen, 2006/01/25
- RE: Documentation for car and cdr, Drew Adams, 2006/01/26
- RE: Documentation for car and cdr, Drew Adams, 2006/01/26
- Re: Documentation for car and cdr, Miles Bader, 2006/01/25
- Re: Documentation for car and cdr, Miles Bader, 2006/01/25
- Re: Documentation for car and cdr, Lennart Borgman, 2006/01/25
- Re: Documentation for car and cdr, Alfred M\. Szmidt, 2006/01/25
- Re: Documentation for car and cdr,
Thien-Thi Nguyen <=
- Re: Documentation for car and cdr, Alan Mackenzie, 2006/01/25
- Re: Documentation for car and cdr, Karl Chen, 2006/01/25
- Re: Documentation for car and cdr, Luc Teirlinck, 2006/01/25
- Re: Documentation for car and cdr, Eli Zaretskii, 2006/01/25
- Re: Documentation for car and cdr, Miles Bader, 2006/01/26
- Re: Documentation for car and cdr, Thien-Thi Nguyen, 2006/01/25
- Re: Documentation for car and cdr, Alan Mackenzie, 2006/01/26
- Re: Documentation for car and cdr, Tomas Zerolo, 2006/01/26
- Re: Documentation for car and cdr, Thien-Thi Nguyen, 2006/01/26
- Re: Documentation for car and cdr, Luc Teirlinck, 2006/01/25