Note that Emacs pauses when handling sentinel errors

Noting this behavior and variable here makes it easier to
understand the behavior of Emacs when a sentinel has an error.

* doc/lispref/processes.texi (Filter Functions): Note that Emacs
pauses when handling sentinel errors.
(Sentinels): Note that Emacs pauses when handling sentinel errors.
(Bug#63096)
This commit is contained in:
Spencer Baugh 2023-05-02 11:37:48 -04:00 committed by Eli Zaretskii
parent 46392c1623
commit fceaf230b0

View file

@ -1755,7 +1755,9 @@ caught automatically, so that it doesn't stop the execution of whatever
program was running when the filter function was started. However, if program was running when the filter function was started. However, if
@code{debug-on-error} is non-@code{nil}, errors are not caught. @code{debug-on-error} is non-@code{nil}, errors are not caught.
This makes it possible to use the Lisp debugger to debug filter This makes it possible to use the Lisp debugger to debug filter
functions. @xref{Debugger}. functions. @xref{Debugger}. If an error is caught, Emacs pauses for
@code{process-error-pause-time} seconds so that the user sees the
error. @xref{Asynchronous Processes}
Many filter functions sometimes (or always) insert the output in the Many filter functions sometimes (or always) insert the output in the
process's buffer, mimicking the actions of the default filter. process's buffer, mimicking the actions of the default filter.
@ -2159,7 +2161,9 @@ automatically, so that it doesn't stop the execution of whatever
programs was running when the sentinel was started. However, if programs was running when the sentinel was started. However, if
@code{debug-on-error} is non-@code{nil}, errors are not caught. @code{debug-on-error} is non-@code{nil}, errors are not caught.
This makes it possible to use the Lisp debugger to debug the This makes it possible to use the Lisp debugger to debug the
sentinel. @xref{Debugger}. sentinel. @xref{Debugger}. If an error is caught, Emacs pauses for
@code{process-error-pause-time} seconds so that the user sees the
error. @xref{Asynchronous Processes}
While a sentinel is running, the process sentinel is temporarily While a sentinel is running, the process sentinel is temporarily
set to @code{nil} so that the sentinel won't run recursively. set to @code{nil} so that the sentinel won't run recursively.