[Emacs-diffs] /srv/bzr/emacs/emacs-23 r99707: Explain how to re-throw a signal.

[Eli Zaretskii]

------------------------------------------------------------
revno: 99707
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-23
timestamp: Wed 2010-03-31 12:43:53 +0300
message:
  Explain how to re-throw a signal.
  
   control.texi (Handling Errors): How to re-throw a signal caught
   by condition-case.
modified:
  doc/lispref/ChangeLog
  doc/lispref/control.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2010-03-26 17:43:01 +0000
+++ b/doc/lispref/ChangeLog     2010-03-31 09:43:53 +0000
@@ -1,3 +1,8 @@
+2010-03-31  Eli Zaretskii  <address@hidden>
+
+       * control.texi (Handling Errors): How to re-throw a signal caught
+       by condition-case.
+
 2010-03-26  Chong Yidong  <address@hidden>
 
        * loading.texi (Hooks for Loading): Document after-load-functions.

=== modified file 'doc/lispref/control.texi'
--- a/doc/lispref/control.texi  2010-01-13 08:35:10 +0000
+++ b/doc/lispref/control.texi  2010-03-31 09:43:53 +0000
@@ -1023,6 +1023,20 @@
 
 If @var{var} is @code{nil}, that means no variable is bound.  Then the
 error symbol and associated data are not available to the handler.
+
address@hidden rethrow a signal
+Sometimes it is necessary to re-throw a signal caught by
address@hidden, for some outer-level handler to catch.  Here's
+how to do that:
+
address@hidden
+  (signal (car err) (cdr err))
address@hidden smallexample
+
address@hidden
+where @code{err} is the error description variable, the first argument
+to @code{condition-case} whose error condition you want to re-throw.
address@hidden of signal}.
 @end defspec
 
 @defun error-message-string error-description
@@ -1109,6 +1123,7 @@
 @end smallexample
 @end defmac
 
+
 @node Error Symbols
 @subsubsection Error Symbols and Condition Names
 @cindex error symbol