emacs-devel
[Top][All Lists]
Advanced

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

Re: The doc-strings for car and cdr are insulting.


From: Richard Stallman
Subject: Re: The doc-strings for car and cdr are insulting.
Date: Fri, 29 Oct 2004 00:32:25 -0400

    How about something like the following, changing "LIST" to "CONS", and
    using "lhs" and "rhs":

    "car is a built-in function.
     (car CONS)

     Return the \"left hand side\" of CONS.  If CONS is nil, return nil.
     If CONS is a list, the car is its first element.
     Error if arg is not nil and not a cons cell.  See also `car-safe'."

    and

    "cdr is a built-in function.
     (cdr CONS)

    Return the \"right hand side\" of CONS.  If CONS is nil, return nil.
    If CONS is a list, the cdr is the list without its first element.
    Error if arg is not nil and not a cons cell.  See also `cdr-safe'."

These are good.




reply via email to

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