mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-18 18:05:07 +00:00
Code Issues Releases Activity

Document debug-on-event

Browse Source 
* doc/lispref/debugging.texi (Error Debugging): Mention debug-on-event.
* doc/lispref/commands.texi (Misc Events): Mention sigusr1,2 and debugging.
* etc/NEWS: Related edit.
This commit is contained in:
Glenn Morris 2012-02-04 13:58:00 -08:00
parent 1f5e1a1648
commit 7aa5aad87e
4 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/lispref/ChangeLog
View File

@ -1,5 +1,8 @@
2012-02-04 Glenn Morris <rgm@gnu.org>
* debugging.texi (Error Debugging): Mention debug-on-event.
* commands.texi (Misc Events): Mention sigusr1,2 and debugging.
* modes.texi (Running Hooks): Try to clarify with-wrapper-hook.
* text.texi (Buffer Contents):

1
doc/lispref/commands.texi
View File

@ -1696,6 +1696,7 @@ parameters are used to display the help-echo text are described in
These events are generated when the Emacs process receives
the signals @code{SIGUSR1} and @code{SIGUSR2}. They contain no
additional data because signals do not carry additional information.
They can be useful for debugging (@pxref{Error Debugging}).
To catch a user signal, bind the corresponding event to an interactive
command in the @code{special-event-map} (@pxref{Active Keymaps}).

9
doc/lispref/debugging.texi
View File

@ -146,6 +146,15 @@ enter the debugger.
@strong{Warning:} @code{debug-on-signal} has no effect when
@code{debug-on-error} is @code{nil}.
@end defopt
@defopt debug-on-event
If you set @code{debug-on-event} to a special event (@pxref{Special
Events}), Emacs will try to enter the debugger as soon as it receives
this event, bypassing @code{special-event-map}. At present, the only
supported values correspond to the signals @code{SIGUSR1} and
@code{SIGUSR2}. This can be helpful when @code{inhibit-quit} is set
and Emacs is not otherwise responding.
@end defopt
To debug an error that happens during loading of the init

4
etc/NEWS
View File

@ -1403,7 +1403,9 @@ as well as those in the -*- line.
** keymaps can inherit from multiple parents.
** `debug-on-event' lets you debug Emacs when stuck because of inhibit-quit.
+++
** Set `debug-on-event' to make Emacs enter the debugger e.g. on receipt
of SIGUSR1. This can be useful when `inhibit-quit' is set.
+++
** New reader macro ## which stands for the empty symbol.