changeset 60375:335c04088898

(Error Debugging): Document stack-trace-on-error.
author Lute Kamstra <lute@gnu.org>
date Fri, 04 Mar 2005 14:53:15 +0000
parents e68c831d220c
children 4f506e54cd57
files lispref/debugging.texi
diffstat 1 files changed, 14 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/debugging.texi	Fri Mar 04 14:48:14 2005 +0000
+++ b/lispref/debugging.texi	Fri Mar 04 14:53:15 2005 +0000
@@ -166,6 +166,20 @@
           (lambda () (setq debug-on-error t)))
 @end example
 
+When the debugger is entered, it shows a backtrace (@pxref{Using
+Debugger}).  If you like to see the backtrace when an error happens,
+but you do not want to enter the debugger, you can set the variable
+@code{stack-trace-on-error} to non-@code{nil}.
+
+@defopt stack-trace-on-error
+This variable determines whether a backtrace buffer is shown when an
+error is signalled and not handled.  If @code{stack-trace-on-error} is
+@code{t}, all kinds of errors display a backtrace; if it is
+@code{nil}, none do.  If the value is a list, an error only means to
+display a backtrace if one of its condition symbols appears in the
+list.
+@end defopt
+
 @node Infinite Loops
 @subsection Debugging Infinite Loops
 @cindex infinite loops