emacs-diffs
[Top][All Lists]
Advanced

[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.
 


reply via email to

[Prev in Thread] Current Thread [Next in Thread]