]> git.eshelyaron.com Git - emacs.git/commitdiff
Clarify condition-case docstring
authorNoam Postavsky <npostavs@gmail.com>
Sun, 16 Sep 2018 23:39:06 +0000 (19:39 -0400)
committerNoam Postavsky <npostavs@gmail.com>
Mon, 17 Sep 2018 00:25:45 +0000 (20:25 -0400)
* src/eval.c (Fcondition_case): Note that it handles non-error symbols
too.

src/eval.c

index 500427cb62b43f95fccedb2b57444ef94b724adb..5e25caaa847cf8e0cd92596449f9d7f2a050857e 100644 (file)
@@ -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