From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Lennart Borgman" Newsgroups: gmane.emacs.devel Subject: Re: The doc-strings for car and cdr are insulting. Date: Fri, 29 Oct 2004 12:12:07 +0200 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <05be01c4bda0$62b98940$0200a8c0@sedrcw11488> References: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="Windows-1252" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1099045061 22469 80.91.229.6 (29 Oct 2004 10:17:41 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 29 Oct 2004 10:17:41 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 29 12:17:29 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CNTp3-0003lA-00 for ; Fri, 29 Oct 2004 12:17:29 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CNTwt-0007La-4w for ged-emacs-devel@m.gmane.org; Fri, 29 Oct 2004 06:25:35 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CNTwZ-0007LU-54 for emacs-devel@gnu.org; Fri, 29 Oct 2004 06:25:15 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CNTwY-0007LI-BC for emacs-devel@gnu.org; Fri, 29 Oct 2004 06:25:14 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CNTwX-0007LF-Bt for emacs-devel@gnu.org; Fri, 29 Oct 2004 06:25:14 -0400 Original-Received: from [81.228.11.114] (helo=av7-2-sn1.fre.skanova.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CNTnv-0005Fo-Uf for emacs-devel@gnu.org; Fri, 29 Oct 2004 06:16:20 -0400 Original-Received: by av7-2-sn1.fre.skanova.net (Postfix, from userid 502) id 063B937F71; Fri, 29 Oct 2004 12:16:19 +0200 (CEST) Original-Received: from smtp3-1-sn1.fre.skanova.net (smtp3-1-sn1.fre.skanova.net [81.228.11.163]) by av7-2-sn1.fre.skanova.net (Postfix) with ESMTP id E9B7A37F6A; Fri, 29 Oct 2004 12:16:18 +0200 (CEST) Original-Received: from sedrcw11488 (t3o58p92.telia.com [195.252.56.92]) by smtp3-1-sn1.fre.skanova.net (Postfix) with SMTP id 0812D37E4A; Fri, 29 Oct 2004 12:16:17 +0200 (CEST) Original-To: "Alan Mackenzie" X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2800.1409 X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2800.1409 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:29139 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:29139 ----- Original Message ----- From: "Richard Stallman" To: "Alan Mackenzie" : 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. As someone who just recently learned elisp I have to agree. Much better than the old version. It was just by chance I happened to find out about CONS. (Like most "users" I only read the manual when I have too ;-) This will be a quicker road to learn. Actually I would like some links saying for more info see the Elisp Info pages, pointing to some relevant page there. (But I guess that is not something for now.) - Lennart