[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] master 3a2ffa6 3/3: Clarify condition-case docstring
From: |
Noam Postavsky |
Subject: |
[Emacs-diffs] master 3a2ffa6 3/3: Clarify condition-case docstring |
Date: |
Sun, 16 Sep 2018 20:35:22 -0400 (EDT) |
branch: master
commit 3a2ffa62a7e491fda1083cbedb165a3e49fd21c6
Author: Noam Postavsky <address@hidden>
Commit: Noam Postavsky <address@hidden>
Clarify condition-case docstring
* src/eval.c (Fcondition_case): Note that it handles non-error symbols
too.
---
src/eval.c | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/src/eval.c b/src/eval.c
index 500427c..5e25caa 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