From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Gareth Rees Newsgroups: gmane.emacs.bugs Subject: Manual for `cl' package is out of date Date: Tue, 23 Oct 2007 13:22:27 +0100 Message-ID: <471DE783.6070006@pobox.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1193142417 12210 80.91.229.12 (23 Oct 2007 12:26:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 23 Oct 2007 12:26:57 +0000 (UTC) Cc: Gareth Rees To: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 23 14:26:57 2007 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IkIqQ-0001P4-0O for geb-bug-gnu-emacs@m.gmane.org; Tue, 23 Oct 2007 14:26:50 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IkIqH-0002t4-U0 for geb-bug-gnu-emacs@m.gmane.org; Tue, 23 Oct 2007 08:26:41 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IkIqE-0002p8-5Z for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2007 08:26:38 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IkIqB-0002lS-Oe for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2007 08:26:37 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IkIqB-0002l7-98 for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2007 08:26:35 -0400 Original-Received: from bowser.zoonami.com ([193.112.141.193]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1IkIqA-0000yo-ME for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2007 08:26:35 -0400 Original-Received: from [193.112.141.207] (ermintrude.zoonami.com [193.112.141.207]) by bowser.zoonami.com (8.12.11/8.12.11) with ESMTP id l9NCR3xt049299; Tue, 23 Oct 2007 13:27:07 +0100 (BST) (envelope-from gareth.rees@pobox.com) User-Agent: Thunderbird 1.5.0.12 (Windows/20070509) X-Virus-Scanned: ClamAV 0.90.1/4573/Tue Oct 23 13:01:01 2007 on bowser.zoonami.com X-Virus-Status: Clean X-detected-kernel: by monty-python.gnu.org: FreeBSD 4.6-4.9 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:16811 Archived-At: The manual for the `cl' package is out of date in a couple places. Node "(cl)Porting Common Lisp" says: * Reader macros. Common Lisp includes a second type of macro that works at the level of individual characters. For example, Common Lisp implements the quote notation by a reader macro called `'', whereas Emacs Lisp's parser just treats quote as a special case. Some Lisp packages use reader macros to create special syntaxes for themselves, which the Emacs parser is incapable of reading. The lack of reader macros, incidentally, is the reason behind Emacs Lisp's unusual backquote syntax. Since backquotes are implemented as a Lisp package and not built-in to the Emacs parser, they are forced to use a regular macro named ``' which is used with the standard function/macro call notation. This has become a bit misleading: it's still true that Emacs Lisp lacks reader macros but Emacs Lisp's backquote syntax is no longer "unusual" because backquote is now handled in the reader. Maybe just delete the second paragraph? Further down in "(cl)Porting Common Lisp": * Characters are distinct from integers in Common Lisp. The notation for character constants is also different: `#\A' instead of `?A'. `?A' is now supported in Emacs. Node "(cl)Top" offers this menu item: * Lists:: `cadr', `sublis', `member*', `assoc*', etc. The function `cadr' is no longer described in this node. The menu item should mention `caddr' instead. -- Gareth Rees