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: Richard M. Stallman
Subject: Re: Documentation for car and cdr
Date: Fri, 27 Jan 2006 17:32:05 -0500

    Violates the convention stated in `(elisp)Documentation Tips' that the
    first line of a docstring should not be wider than 67 characters.
    (71 in this case.)

That is unfortunate but could be solved like this:

       Return the car of cons cell (or list) CONS.  Given nil, return nil.


                        The only list that is not a cons cell is nil,
    which is mentioned on the same line.

The goal here is not to write the minimal logically correct statement.
The goal is to be helpful.




reply via email to

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