From: Noam Postavsky <npostavs@gmail.com>
Date: Sun, 16 Sep 2018 23:39:06 +0000 (-0400)
Subject: Clarify condition-case docstring
X-Git-Tag: emacs-27.0.90~4403
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3a2ffa62a7e491fda1083cbedb165a3e49fd21c6;p=emacs.git

Clarify condition-case docstring

* src/eval.c (Fcondition_case): Note that it handles non-error symbols
too.
---

diff --git a/src/eval.c b/src/eval.c
index 500427cb62b..5e25caaa847 100644
--- a/src/eval.c
+++ b/src/eval.c
@@ -1238,8 +1238,10 @@ Each element of HANDLERS looks like (CONDITION-NAME BODY...)
 where the BODY is made of Lisp expressions.
 
 A handler is applicable to an error if CONDITION-NAME is one of the
-error's condition names.  A CONDITION-NAME of t applies to any error
-symbol.  If an error happens, the first applicable handler is run.
+error's condition names.  Handlers may also apply when non-error
+symbols are signaled (e.g., `quit').  A CONDITION-NAME of t applies to
+any symbol, including non-error symbols.  If multiple handlers are
+applicable, only the first one runs.
 
 The car of a handler may be a list of condition names instead of a
 single condition name; then it handles all of them.  If the special