(Using Debugger): Mention @code{eval-expression-debug-on-error}

Fixes: debbugs:8549

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 153d7e839c3d05fdcf1b85987f98842dd892a2b8..cf6e3482efb97e55895ded56fa97903e88e1ed6a 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-07-15  Lars Magne Ingebrigtsen  <larsi@gnus.org>
+
+       * debugging.texi (Using Debugger): Mention
+       @code{eval-expression-debug-on-error} (bug#8549).
+
 2011-07-14  Eli Zaretskii  <eliz@gnu.org>
 
        * display.texi (Other Display Specs): Document that `left-fringe'

diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi
index ed146453df7ca86cd4fa265b8ac9a31283dd3081..d9e807afb88a68b290c246fb5cd50d582c52f6bc 100644 (file)
--- a/doc/lispref/debugging.texi
+++ b/doc/lispref/debugging.texi
@@ -306,6 +306,16 @@ and it is wise to go back to the backtrace buffer and exit the debugger
 the debugger gets out of the recursive edit and kills the backtrace
 buffer.
 
+  When the debugger has been entered, the @code{debug-on-error}
+variable is temporarily set according to
+@code{eval-expression-debug-on-error}.  If the latter variable is
+non-@code{nil}, @code{debug-on-error} will temporarily be set to
+@code{t}.  This means that any further errors that occur while doing a
+debugging session will (by default) trigger another backtrace.  If
+this is not want you want, you can either set
+@code{eval-expression-debug-on-error} to @code{nil}, or set
+@code{debug-on-error} to @code{nil} in @code{debugger-mode-hook}.
+
 @cindex current stack frame
   The backtrace buffer shows you the functions that are executing and
 their argument values.  It also allows you to specify a stack frame by