; Update the documentation of 'debug'

This commit is contained in:
Eli Zaretskii 2026-05-30 13:41:22 +03:00
parent 69fd4b87f4
commit 72d890c43e
2 changed files with 8 additions and 5 deletions

View file

@ -638,11 +638,9 @@ debugger, etc.), and fills it with information about the stack of Lisp
function calls. It then enters a recursive edit, showing the function calls. It then enters a recursive edit, showing the
backtrace buffer in Debugger mode. In batch mode (more generally, backtrace buffer in Debugger mode. In batch mode (more generally,
when @code{noninteractive} is non-@code{nil}, @pxref{Batch Mode}), when @code{noninteractive} is non-@code{nil}, @pxref{Batch Mode}),
this function shows the Lisp backtrace on the standard error stream, this function shows the Lisp backtrace on the standard error stream.
and then kills Emacs, causing it to exit with a non-zero exit code Binding @code{backtrace-on-error-noninteractive} to @code{nil}
(@pxref{Killing Emacs}). Binding suppresses the backtrace in batch mode, see below.
@code{backtrace-on-error-noninteractive} to @code{nil} suppresses the
backtrace in batch mode, see below.
The Debugger mode @kbd{c}, @kbd{d}, @kbd{j}, and @kbd{r} commands exit The Debugger mode @kbd{c}, @kbd{d}, @kbd{j}, and @kbd{r} commands exit
the recursive edit; then @code{debug} switches back to the previous the recursive edit; then @code{debug} switches back to the previous

View file

@ -4222,6 +4222,11 @@ suggestions. So the 'M-?' command now works without a tags table. And
the 'M-.' will show a message describing the several built-in options the 'M-.' will show a message describing the several built-in options
that will provide an Xref backend when used. that will provide an Xref backend when used.
+++
** Calling 'debug' in batch sessions no longer kills Emacs.
If you want Emacs to exit, your program will now have to call
'kill-emacs' explicitly.
* Lisp Changes in Emacs 31.1 * Lisp Changes in Emacs 31.1