[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110835: Document new error symbol
From: |
Glenn Morris |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110835: Document new error symbol and function user-error |
Date: |
Sat, 10 Nov 2012 16:37:40 -0800 |
User-agent: |
Bazaar (2.5.0) |
------------------------------------------------------------
revno: 110835
committer: Glenn Morris <address@hidden>
branch nick: emacs-24
timestamp: Sat 2012-11-10 16:37:40 -0800
message:
Document new error symbol and function user-error
* doc/lispref/control.texi (Signaling Errors):
* doc/lispref/debugging.texi (Error Debugging):
* doc/lispref/errors.texi (Standard Errors): Add user-error.
* etc/NEWS: Related markup.
modified:
doc/lispref/ChangeLog
doc/lispref/control.texi
doc/lispref/debugging.texi
doc/lispref/errors.texi
etc/NEWS
=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog 2012-11-11 00:20:51 +0000
+++ b/doc/lispref/ChangeLog 2012-11-11 00:37:40 +0000
@@ -1,5 +1,9 @@
2012-11-11 Glenn Morris <address@hidden>
+ * control.texi (Signaling Errors):
+ * debugging.texi (Error Debugging):
+ * errors.texi (Standard Errors): Add user-error.
+
* variables.texi (Adding Generalized Variables):
Use standard formatting for common lisp note about setf functions.
=== modified file 'doc/lispref/control.texi'
--- a/doc/lispref/control.texi 2012-10-31 21:00:57 +0000
+++ b/doc/lispref/control.texi 2012-11-11 00:37:40 +0000
@@ -824,6 +824,19 @@
@end example
@end defun
address@hidden user errors, signaling
address@hidden user-error format-string &rest args
+This function behaves exactly like @code{error}, except that it uses
+the error symbol @code{user-error} rather than @code{error}. As the
+name suggests, this is intended to report errors on the part of the
+user, rather than errors in the code itself. For example,
+if you try to use the command @code{Info-history-back} (@kbd{l}) to
+move back beyond the start of your Info browsing history, Emacs
+signals a @code{user-error}. Such errors do not cause entry to the
+debugger, even when @code{debug-on-error} is address@hidden
address@hidden Debugging}.
address@hidden defun
+
@cindex CL note---no continuable errors
@quotation
@b{Common Lisp note:} Emacs Lisp has nothing like the Common Lisp
=== modified file 'doc/lispref/debugging.texi'
--- a/doc/lispref/debugging.texi 2012-09-21 03:03:48 +0000
+++ b/doc/lispref/debugging.texi 2012-11-11 00:37:40 +0000
@@ -117,12 +117,12 @@
any of the regular expressions, then that error does not enter the
debugger.
-The normal value of this variable lists several errors that happen
-often during editing but rarely result from bugs in Lisp programs.
-However, ``rarely'' is not ``never''; if your program fails with an
-error that matches this list, you may try changing this list to debug
-the error. The easiest way is usually to set
address@hidden to @code{nil}.
+The normal value of this variable includes @code{user-error}, as well
+as several errors that happen often during editing but rarely result
+from bugs in Lisp programs. However, ``rarely'' is not ``never''; if
+your program fails with an error that matches this list, you may try
+changing this list to debug the error. The easiest way is usually to
+set @code{debug-ignored-errors} to @code{nil}.
@end defopt
@defopt eval-expression-debug-on-error
=== modified file 'doc/lispref/errors.texi'
--- a/doc/lispref/errors.texi 2012-10-31 20:59:04 +0000
+++ b/doc/lispref/errors.texi 2012-11-11 00:37:40 +0000
@@ -172,6 +172,9 @@
@item undefined-color
The message is @samp{Undefined color}. @xref{Color Names}.
address@hidden user-error
+The message is the empty string. @xref{Signaling Errors}.
+
@item void-function
The message is @samp{Symbol's function definition is void}.
@xref{Function Cells}.
=== modified file 'etc/NEWS'
--- a/etc/NEWS 2012-11-10 01:50:56 +0000
+++ b/etc/NEWS 2012-11-11 00:37:40 +0000
@@ -800,6 +800,7 @@
** Debugger changes
++++
*** New error type and new function `user-error'.
These do not trigger the debugger.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/emacs-24 r110835: Document new error symbol and function user-error,
Glenn Morris <=