GNU bug report logs - #9082
Add hints to documentation of car and cdr for (e)lisp newcomers

Previous Next

Package: emacs;

Reported by: asjo <at> koldfront.dk (Adam Sjøgren)

Date: Thu, 14 Jul 2011 16:42:02 UTC

Severity: minor

Tags: fixed

Fixed in version 24.1

Done: Lars Magne Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log

Message #12 received at 9082 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: asjo <at> koldfront.dk (Adam Sjøgren)
Cc: 9082 <at> debbugs.gnu.org
Subject: Re: Add hints to documentation of car and cdr for (e)lisp newcomers
Date: Thu, 14 Jul 2011 20:31:32 +0200

asjo <at> koldfront.dk (Adam Sjøgren) writes:

> 2011-07-14  Adam Sjøgren  <asjo <at> koldfront.dk>
>
> 	* data.c (car, cdr): add functionality hints to documentation.

I've applied your patch to Emacs 24, although...

>   DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
> !        doc: /* Return the cdr (rest) of LIST.  If arg is nil, return nil.

this is kinda still wrong-ish.  I mean, you can take the cdr of a cons
cell.  The cdr isn't more `rest' then the car is.  However, since the
documentation says LIST, I guess it's OK.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/
This bug report was last modified 13 years and 317 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.