From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: Documentation for car and cdr Date: Wed, 25 Jan 2006 16:11:03 -0600 (CST) Message-ID: <200601252211.k0PMB3618664@raven.dms.auburn.edu> References: NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1138227328 31742 80.91.229.2 (25 Jan 2006 22:15:28 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 25 Jan 2006 22:15:28 +0000 (UTC) Cc: mario.goulart@gmail.com, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jan 25 23:15:22 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1F1sv2-0004VM-Ag for ged-emacs-devel@m.gmane.org; Wed, 25 Jan 2006 23:15:12 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1F1sxn-0006oq-B0 for ged-emacs-devel@m.gmane.org; Wed, 25 Jan 2006 17:18:03 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1F1sx7-0006e5-T9 for emacs-devel@gnu.org; Wed, 25 Jan 2006 17:17:22 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1F1sx6-0006c2-0u for emacs-devel@gnu.org; Wed, 25 Jan 2006 17:17:20 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1F1sx5-0006bQ-9y for emacs-devel@gnu.org; Wed, 25 Jan 2006 17:17:19 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.52) id 1F1suT-00007F-RK; Wed, 25 Jan 2006 17:14:37 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.13.3+Sun/8.13.3) with ESMTP id k0PMEK7u014060; Wed, 25 Jan 2006 16:14:21 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id k0PMB3618664; Wed, 25 Jan 2006 16:11:03 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: acm@muc.de In-reply-to: (message from Alan Mackenzie on Wed, 25 Jan 2006 19:54:36 +0000 (GMT)) X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-2.0.1 (manatee.dms.auburn.edu [131.204.53.104]); Wed, 25 Jan 2006 16:14:21 -0600 (CST) 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: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:49542 Archived-At: Describing basic concepts like car, cdr, cons cell, list and so on is the task of manuals, not of docstrings. If somebody is not familiar with the basic concepts, they have to read a manual, where those concepts can be put into the proper context, _not_ individual docstrings. There are two different Elisp manuals included with the Emacs distribution. Why on earth would a beginning Elisp programmer try to learn Elisp exclusively through the docstrings rather than through the one of these two manuals? Sincerely, Luc.