From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Joe Wells Newsgroups: gmane.emacs.bugs Subject: bug#782: discrepancy between manual and function help text for condition-case Date: Tue, 26 Aug 2008 16:45:33 +0100 Message-ID: <86prnvzso2.fsf@blueyonder.co.uk> Reply-To: Joe Wells , 782@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1219767110 2441 80.91.229.12 (26 Aug 2008 16:11:50 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 26 Aug 2008 16:11:50 +0000 (UTC) To: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Aug 26 18:12:43 2008 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 1KY19l-0005Nq-VJ for geb-bug-gnu-emacs@m.gmane.org; Tue, 26 Aug 2008 18:12:34 +0200 Original-Received: from localhost ([127.0.0.1]:52550 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KY18n-0004jW-L7 for geb-bug-gnu-emacs@m.gmane.org; Tue, 26 Aug 2008 12:11:33 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KY14v-0000SD-GK for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 12:07:33 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KY14t-0000Pu-O6 for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 12:07:32 -0400 Original-Received: from [199.232.76.173] (port=51968 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KY14t-0000PZ-C6 for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 12:07:31 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:57541) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KY14s-00082b-Un for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 12:07:31 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m7QG7SnQ006428; Tue, 26 Aug 2008 09:07:29 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id m7QFt531001603; Tue, 26 Aug 2008 08:55:05 -0700 X-Loop: don@donarmstrong.com Resent-From: Joe Wells Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Tue, 26 Aug 2008 15:55:05 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 782 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.121976555431983 (code B ref -1); Tue, 26 Aug 2008 15:55:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 26 Aug 2008 15:45:54 +0000 Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m7QFjmbM031977 for ; Tue, 26 Aug 2008 08:45:49 -0700 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KY0jr-0003y1-Cq for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 11:45:47 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KY0jn-0003vm-9f for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 11:45:47 -0400 Original-Received: from [199.232.76.173] (port=56007 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KY0jm-0003vg-Vf for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 11:45:43 -0400 Original-Received: from smtp-out4.blueyonder.co.uk ([195.188.213.7]:58185) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KY0jm-0002nf-5D for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 11:45:42 -0400 Original-Received: from [172.23.170.146] (helo=anti-virus03-09) by smtp-out4.blueyonder.co.uk with smtp (Exim 4.52) id 1KY0jg-0003Kf-H9 for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 16:45:36 +0100 Original-Received: from [82.41.74.248] (helo=127.0.0.1) by asmtp-out1.blueyonder.co.uk with smtp (Exim 4.52) id 1KY0jf-0006jU-Cm for bug-gnu-emacs@gnu.org; Tue, 26 Aug 2008 16:45:35 +0100 Original-Received: (nullmailer pid 17818 invoked by uid 1001); Tue, 26 Aug 2008 15:45:33 -0000 X-Mail-Via: blue User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1 (gnu/linux) SMTP-Host: smtp.blueyonder.co.uk SMTP-Port: 25 X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 3) Resent-Date: Tue, 26 Aug 2008 12:07:32 -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:19723 Archived-At: Dear Emacs maintainers, Evaluating (describe-function 'condition-case) displays a buffer containing (amongst other things), this text: When a handler handles an error, control returns to the condition-case and the handler BODY... is executed with var bound to (SIGNALED-CONDITIONS . SIGNAL-DATA). In contrast, evaluating (info "(elisp)Handling Errors") displays (amongst other things) this text: The argument VAR is a variable. `condition-case' does not bind this variable when executing the PROTECTED-FORM, only when it handles an error. At that time, it binds VAR locally to an "error description", which is a list giving the particulars of the error. The error description has the form `(ERROR-SYMBOL . DATA)'. I believe the text in the Elisp manual is the correct one. That is, I think the correct text is that the car of the value bound to the variable is the error symbol, not the list of error conditions. Can someone please fix this? -- Joe ====================================================================== In GNU Emacs 22.1.1 (i686-pc-linux-gnu, GTK+ Version 2.8.20) of 2007-06-27 on artemis Windowing system distributor `The X.Org Foundation', version 11.0.70000000 configured using `configure '--prefix=/home/jbw/local2' '--enable-debug' '--disable-nls' '--with-x-toolkit=gtk' 'CFLAGS=-O0 -g3 -ggdb''