[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#782: discrepancy between manual and function help text for condition
From: |
Joe Wells |
Subject: |
bug#782: discrepancy between manual and function help text for condition-case |
Date: |
Tue, 26 Aug 2008 16:45:33 +0100 |
User-agent: |
Gnus/5.11 (Gnus v5.11) Emacs/22.1 (gnu/linux) |
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''
- bug#782: discrepancy between manual and function help text for condition-case,
Joe Wells <=