From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: The doc-strings for car and cdr are insulting.
Date: Fri, 29 Oct 2004 00:32:25 -0400
Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Message-ID: <E1CNOR7-000679-BR@fencepost.gnu.org>
References: <Pine.LNX.3.96.1041027183957.614A-100000@acm.acm>
Reply-To: rms@gnu.org
NNTP-Posting-Host: deer.gmane.org
X-Trace: sea.gmane.org 1099024485 10057 80.91.229.6 (29 Oct 2004 04:34:45 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Fri, 29 Oct 2004 04:34:45 +0000 (UTC)
Cc: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 29 06:34:39 2004
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Original-Received: from lists.gnu.org ([199.232.76.165])
	by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian))
	id 1CNOTH-0002Ni-00
	for <ged-emacs-devel@m.gmane.org>; Fri, 29 Oct 2004 06:34:39 +0200
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.33)
	id 1CNOb6-0000lx-Dn
	for ged-emacs-devel@m.gmane.org; Fri, 29 Oct 2004 00:42:44 -0400
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33)
	id 1CNOaE-0000Sb-N1
	for emacs-devel@gnu.org; Fri, 29 Oct 2004 00:41:50 -0400
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33)
	id 1CNOaB-0000RY-SY
	for emacs-devel@gnu.org; Fri, 29 Oct 2004 00:41:48 -0400
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.33) id 1CNOaB-0000QL-Ja
	for emacs-devel@gnu.org; Fri, 29 Oct 2004 00:41:47 -0400
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.34) id 1CNORu-0005eN-D4
	for emacs-devel@gnu.org; Fri, 29 Oct 2004 00:33:14 -0400
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34)
	id 1CNOR7-000679-BR; Fri, 29 Oct 2004 00:32:25 -0400
Original-To: Alan Mackenzie <acm@muc.de>
In-reply-to: <Pine.LNX.3.96.1041027183957.614A-100000@acm.acm> (message from
	Alan Mackenzie on Wed, 27 Oct 2004 18:56:22 +0000 (GMT))
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Xref: main.gmane.org gmane.emacs.devel:29131
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:29131

    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.