bug-gnu-emacs
[Top][All Lists]
Advanced

[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''








reply via email to

[Prev in Thread] Current Thread [Next in Thread]