diff options
| author | Lute Kamstra | 2005-06-14 11:36:41 +0000 |
|---|---|---|
| committer | Lute Kamstra | 2005-06-14 11:36:41 +0000 |
| commit | cf02d3ed214a099fa56b4007d472d69e46411de0 (patch) | |
| tree | 33417ba68fbce128166b95558d7a347b01a5281b | |
| parent | ebb7de8462af1636e625e756c780d48034b65882 (diff) | |
| download | emacs-cf02d3ed214a099fa56b4007d472d69e46411de0.tar.gz emacs-cf02d3ed214a099fa56b4007d472d69e46411de0.zip | |
(Function Debugging): Primitives can break on entry too.
| -rw-r--r-- | lispref/debugging.texi | 22 |
1 files changed, 13 insertions, 9 deletions
diff --git a/lispref/debugging.texi b/lispref/debugging.texi index ae3fbdbb480..739dd1fe298 100644 --- a/lispref/debugging.texi +++ b/lispref/debugging.texi | |||
| @@ -210,15 +210,19 @@ called shortly before the problem, step quickly over the call to that | |||
| 210 | function, and then step through its caller. | 210 | function, and then step through its caller. |
| 211 | 211 | ||
| 212 | @deffn Command debug-on-entry function-name | 212 | @deffn Command debug-on-entry function-name |
| 213 | This function requests @var{function-name} to invoke the debugger each time | 213 | This function requests @var{function-name} to invoke the debugger each |
| 214 | it is called. It works by inserting the form @code{(debug 'debug)} into | 214 | time it is called. It works by inserting the form |
| 215 | the function definition as the first form. | 215 | @code{(implement-debug-on-entry)} into the function definition as the |
| 216 | 216 | first form. | |
| 217 | Any function defined as Lisp code may be set to break on entry, | 217 | |
| 218 | regardless of whether it is interpreted code or compiled code. If the | 218 | Any function or macro defined as Lisp code may be set to break on |
| 219 | function is a command, it will enter the debugger when called from Lisp | 219 | entry, regardless of whether it is interpreted code or compiled code. |
| 220 | and when called interactively (after the reading of the arguments). You | 220 | If the function is a command, it will enter the debugger when called |
| 221 | can't debug primitive functions (i.e., those written in C) this way. | 221 | from Lisp and when called interactively (after the reading of the |
| 222 | arguments). You can also set debug-on-entry for primitive functions | ||
| 223 | (i.e., those written in C) this way, but it only takes effect when the | ||
| 224 | primitive is called from Lisp code. Debug-on-entry is not allowed for | ||
| 225 | special forms. | ||
| 222 | 226 | ||
| 223 | When @code{debug-on-entry} is called interactively, it prompts for | 227 | When @code{debug-on-entry} is called interactively, it prompts for |
| 224 | @var{function-name} in the minibuffer. If the function is already set | 228 | @var{function-name} in the minibuffer. If the function is already set |