From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: storm@cua.dk (Kim F. Storm) Newsgroups: gmane.emacs.devel Subject: Re: doc strings of reverse and nreverse. Date: 20 Nov 2003 11:42:56 +0100 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200311200410.hAK4Axt07727@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1069321661 20981 80.91.224.253 (20 Nov 2003 09:47:41 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 20 Nov 2003 09:47:41 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Thu Nov 20 10:47:38 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AMlPW-0004Fe-00 for ; Thu, 20 Nov 2003 10:47:38 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AMlPW-0002Yf-00 for ; Thu, 20 Nov 2003 10:47:38 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AMmKn-0001FY-Vc for emacs-devel@quimby.gnus.org; Thu, 20 Nov 2003 05:46:49 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AMmJE-0000qA-BI for emacs-devel@gnu.org; Thu, 20 Nov 2003 05:45:12 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AMmIh-0000hv-0F for emacs-devel@gnu.org; Thu, 20 Nov 2003 05:45:11 -0500 Original-Received: from [212.88.64.25] (helo=mail-relay.sonofon.dk) by monty-python.gnu.org with smtp (Exim 4.24) id 1AMmIg-0000hP-5O for emacs-devel@gnu.org; Thu, 20 Nov 2003 05:44:38 -0500 Original-Received: (qmail 74790 invoked from network); 20 Nov 2003 09:43:11 -0000 Original-Received: from unknown (HELO kfs-l.imdomain.dk.cua.dk) (213.83.150.2) by 0 with SMTP; 20 Nov 2003 09:43:11 -0000 Original-To: Luc Teirlinck In-Reply-To: <200311200410.hAK4Axt07727@raven.dms.auburn.edu> Original-Lines: 27 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:17953 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17953 Luc Teirlinck writes: > The doc strings of `reverse' and `nreverse' are strange and cryptic. > > Do C-h f reverse RET > > Result: > > reverse is a built-in function. > (reverse LIST) > > Reverse LIST, copying. Returns the beginning of the reversed list. > See also the function `nreverse', which is used more often. > > My comments: > > The "beginning" of the reversed list? How much of the beginning? It's "beginning of list" in the meaning "pointer to first element in the list". Which in our book is just "the list". I agree that "beginning of" should be removed from doc strings. -- Kim F. Storm http://www.cua.dk