From c838708452e293d8d55f1476f599eff28b94f255 Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Tue, 8 Jul 2014 14:24:39 -0400 Subject: [PATCH] * doc/lispref/debugging.texi (Function Debugging, Debugger Commands): Update debug-on-entry w.r.t behavior after redefinitions. Fixes: debbugs:17902 --- doc/lispref/ChangeLog | 5 +++++ doc/lispref/debugging.texi | 19 ++----------------- 2 files changed, 7 insertions(+), 17 deletions(-) diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 2464eda28cb..a3353c66f71 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,8 @@ +2014-07-08 Stefan Monnier + + * debugging.texi (Function Debugging, Debugger Commands): + Update debug-on-entry w.r.t behavior after redefinitions (bug#17902). + 2014-06-29 Glenn Morris * help.texi (Help Functions): "Online" help doesn't mean what it diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi index a9d0c1c4ed0..66f12a022cb 100644 --- a/doc/lispref/debugging.texi +++ b/doc/lispref/debugging.texi @@ -226,9 +226,7 @@ function, and then step through its caller. @deffn Command debug-on-entry function-name This function requests @var{function-name} to invoke the debugger each -time it is called. It works by inserting the form -@code{(implement-debug-on-entry)} into the function definition as the -first form. +time it is called. Any function or macro defined as Lisp code may be set to break on entry, regardless of whether it is interpreted code or compiled code. @@ -244,11 +242,6 @@ When @code{debug-on-entry} is called interactively, it prompts for up to invoke the debugger on entry, @code{debug-on-entry} does nothing. @code{debug-on-entry} always returns @var{function-name}. -@strong{Warning:} if you redefine a function after using -@code{debug-on-entry} on it, the code to enter the debugger is -discarded by the redefinition. In effect, redefining the function -cancels the break-on-entry feature for that function. - Here's an example to illustrate use of this function: @example @@ -277,12 +270,6 @@ Debugger entered--entering a function: ------ Buffer: *Backtrace* ------ @end group -@group -(symbol-function 'fact) - @result{} (lambda (n) - (debug (quote debug)) - (if (zerop n) 1 (* n (fact (1- n))))) -@end group @end example @end deffn @@ -461,9 +448,7 @@ You can't use @kbd{r} when the debugger was entered due to an error. @item l Display a list of functions that will invoke the debugger when called. This is a list of functions that are set to break on entry by means of -@code{debug-on-entry}. @strong{Warning:} if you redefine such a -function and thus cancel the effect of @code{debug-on-entry}, it may -erroneously show up in this list. +@code{debug-on-entry}. @item v Toggle the display of local variables of the current stack frame. -- 2.39.5