From e3f0d8dc8b61d20364cf4de84481ecddaa7d04f6 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Sun, 12 May 2002 17:04:51 +0000 Subject: Clarify what signalling an error means. --- lispref/control.texi | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) (limited to 'lispref/control.texi') diff --git a/lispref/control.texi b/lispref/control.texi index 3ba874e7f70..adea5277061 100644 --- a/lispref/control.texi +++ b/lispref/control.texi @@ -733,6 +733,12 @@ instead. @xref{Catch and Throw}. @subsubsection How to Signal an Error @cindex signaling errors + @dfn{Signalling} an error means beginning error processing. Error +processing normally aborts all or part of the running program and +returns to a point that is set up to handle the error +(@pxref{Processing of Errors}). Here we describe how to signal an +error. + Most errors are signaled ``automatically'' within Lisp primitives which you call for other purposes, such as if you try to take the @sc{car} of an integer or move forward a character at the end of the @@ -743,10 +749,11 @@ buffer. You can also signal errors explicitly with the functions considered an error, but it is handled almost like an error. @xref{Quitting}. - The error message should state what is wrong (``File does not -exist''), not how things ought to be (``File must exist''). The -convention in Emacs Lisp is that error messages should start with a -capital letter, but should not end with any sort of punctuation. + Every error specifies an error message, one way or another. The +message should state what is wrong (``File does not exist''), not how +things ought to be (``File must exist''). The convention in Emacs +Lisp is that error messages should start with a capital letter, but +should not end with any sort of punctuation. @defun error format-string &rest args This function signals an error with an error message constructed by -- cgit v1.2.1