From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#4433: 23.1; dolist vs dolist Date: Mon, 14 Sep 2009 12:16:27 -0700 Message-ID: <54A8F211D3B841548475B66901164574@us.oracle.com> Reply-To: Drew Adams , 4433@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1252956442 19182 80.91.229.12 (14 Sep 2009 19:27:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 14 Sep 2009 19:27:22 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Sep 14 21:27:14 2009 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 1MnHCj-00072k-UW for geb-bug-gnu-emacs@m.gmane.org; Mon, 14 Sep 2009 21:27:14 +0200 Original-Received: from localhost ([127.0.0.1]:46141 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MnHCi-0004cS-P1 for geb-bug-gnu-emacs@m.gmane.org; Mon, 14 Sep 2009 15:27:12 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MnHCe-0004c7-7y for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:27:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MnHCZ-0004ba-JG for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:27:07 -0400 Original-Received: from [199.232.76.173] (port=41447 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MnHCZ-0004bX-Cq for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:27:03 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:55509) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MnHCY-0005TU-KK for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:27:02 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8EJR0eQ029329; Mon, 14 Sep 2009 12:27:00 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n8EJP5Mi028931; Mon, 14 Sep 2009 12:25:05 -0700 Resent-Date: Mon, 14 Sep 2009 12:25:05 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Mon, 14 Sep 2009 19:25:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 4433 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125295579227437 (code B ref -1); Mon, 14 Sep 2009 19:25:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 14 Sep 2009 19:16:32 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8EJGVnD027427 for ; Mon, 14 Sep 2009 12:16:32 -0700 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MnH2M-000336-If for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:16:30 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MnH2H-0002x3-CI for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:16:29 -0400 Original-Received: from [199.232.76.173] (port=34806 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MnH2H-0002wr-7L for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:16:25 -0400 Original-Received: from rcsinet11.oracle.com ([148.87.113.123]:33489 helo=rgminet11.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MnH2G-0003E2-Tp for bug-gnu-emacs@gnu.org; Mon, 14 Sep 2009 15:16:25 -0400 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rgminet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n8EJH16J025104 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 14 Sep 2009 19:17:02 GMT Original-Received: from abhmt014.oracle.com (abhmt014.oracle.com [141.146.116.23]) by acsinet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n8EJGYnA018872 for ; Mon, 14 Sep 2009 19:16:35 GMT Original-Received: from dradamslap1 (/141.144.64.128) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 14 Sep 2009 12:16:15 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Aco1b9tm/DkaLSxwR6eTwWTq56sGzA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: abhmt014.oracle.com [141.146.116.23] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090207.4AAE9680.0018:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Mon, 14 Sep 2009 15:27:07 -0400 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:31088 Archived-At: The doc strings for the `dolist' defined in emacs -Q and the `dolist' defined in cl-macs.el are the same. However, the two `dolist's are not the same. At the very least, the doc string for the CL version should mention `return-from' and any other features that it offers and which are not available for the vanilla `dolist'. And the doc string for the vanilla `dolist' should mention that it is not the same as the `dolist' of Common Lisp. Even more important is to document this in the Elisp manual. State clearly that `dolist' (the one provided by Emacs, without cl.el) is not the same as the `dolist' of Common Lisp or the `dolist' of cl.el, both of which support `return-from', and so on. The use of the same name by Emacs for a very different function (macro) is confusing and error prone. The least we can do is point this out in the doc. Note that we do say this in node Catch and Throw: "Common Lisp note: Most other versions of Lisp, including Common Lisp, have several ways of transferring control nonsequentially: `return', `return-from', and `go', for example. Emacs Lisp has only `throw'." A similar note is called for wherever Emacs has a function or macro with the same name as one from Common Lisp, whenever there is a significant difference in behavior. In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600) of 2009-07-29 on SOFT-MJASON Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4)'