diff options
| author | Eli Zaretskii | 2025-08-07 16:38:02 +0300 |
|---|---|---|
| committer | Eli Zaretskii | 2025-08-07 16:38:02 +0300 |
| commit | e9fe0ebae057bd9e9015a16b9b3604a5ceddc0ea (patch) | |
| tree | 1d1ecc1ef2aaf265dfb8476672e629b03683992a /etc | |
| parent | caa6bc95c1b5904bd50c6aee5c70c6994594756c (diff) | |
| download | emacs-e9fe0ebae057bd9e9015a16b9b3604a5ceddc0ea.tar.gz emacs-e9fe0ebae057bd9e9015a16b9b3604a5ceddc0ea.zip | |
; Fix last change
* src/eval.c (Fdebugger_trap): Minor wording changes in doc
string.
* etc/DEBUG: Some copyedits of a recently-added text.
Diffstat (limited to 'etc')
| -rw-r--r-- | etc/DEBUG | 21 |
1 files changed, 12 insertions, 9 deletions
| @@ -211,16 +211,19 @@ the debugger, but before running it, is the most efficient way of | |||
| 211 | making sure control will be returned to the debugger when you need | 211 | making sure control will be returned to the debugger when you need |
| 212 | that. | 212 | that. |
| 213 | 213 | ||
| 214 | There is a default function to give control to the debugger. It is | 214 | The function 'debugger-trap' is a do-nothing interactive command that |
| 215 | called debugger-trap. This is a do-nothing primitive, as a convenient | 215 | exists to give control to the debugger. It is convenient to set a |
| 216 | point to return control to the debugger. You can invoke interactively | 216 | breakpoint there to give control to the debugger when the function is |
| 217 | with "M-x debugger-trap RET". The src/.gdbinit file in the Emacs source | 217 | called. You can invoke it interactively with "M-x debugger-trap RET". |
| 218 | distribution sets a breakpoint on this function. | 218 | The src/.gdbinit file in the Emacs source distribution sets a breakpoint |
| 219 | 219 | in this function, so if you arrange for .gdbinit to be loaded, or load | |
| 220 | 'Fsignal' is a very useful place to put a breakpoint in. All Lisp | 220 | it manually in a debugging session, the breakpoint is set for you |
| 221 | automatically. | ||
| 222 | |||
| 223 | 'Fsignal' is another very useful place to put a breakpoint in. All Lisp | ||
| 221 | errors go through there. If you are only interested in errors that | 224 | errors go through there. If you are only interested in errors that |
| 222 | would fire the Lisp debugger, breaking at 'maybe_call_debugger' is | 225 | would fire the Lisp debugger, breaking at 'maybe_call_debugger' is a |
| 223 | useful. | 226 | useful alternative. |
| 224 | 227 | ||
| 225 | It is also useful to have a guaranteed way to return to the debugger | 228 | It is also useful to have a guaranteed way to return to the debugger |
| 226 | at any arbitrary time. When using X, this is easy: type C-z at the | 229 | at any arbitrary time. When using X, this is easy: type C-z at the |