aboutsummaryrefslogtreecommitdiffstats
path: root/lispref/debugging.texi
diff options
context:
space:
mode:
authorMiles Bader2005-06-15 23:32:15 +0000
committerMiles Bader2005-06-15 23:32:15 +0000
commit2092fd2b3339ac097e1b27643b70211dcb0b4e95 (patch)
tree7f2307bbb82c7f111678885f871d88d44c870d4e /lispref/debugging.texi
parent8786f9fffda045f818e622bddd9c85249dfb9ff7 (diff)
parenta4bf534f1eb1dcb2048f5deeff783c23059e3924 (diff)
downloademacs-2092fd2b3339ac097e1b27643b70211dcb0b4e95.tar.gz
emacs-2092fd2b3339ac097e1b27643b70211dcb0b4e95.zip
Revision: miles@gnu.org--gnu-2005/emacs--unicode--0--patch-63
Merge from emacs--cvs-trunk--0 Patches applied: * emacs--cvs-trunk--0 (patch 358-423) - Update from CVS - Remove "-face" suffix from widget faces - Remove "-face" suffix from custom faces - Remove "-face" suffix from change-log faces - Remove "-face" suffix from compilation faces - Remove "-face" suffix from diff-mode faces - lisp/longlines.el (longlines-visible-face): Face removed - Remove "-face" suffix from woman faces - Remove "-face" suffix from whitespace-highlight face - Remove "-face" suffix from ruler-mode faces - Remove "-face" suffix from show-paren faces - Remove "-face" suffix from log-view faces - Remove "-face" suffix from smerge faces - Remove "-face" suffix from show-tabs faces - Remove "-face" suffix from highlight-changes faces - Remove "-face" suffix from and downcase info faces - Remove "-face" suffix from pcvs faces - Update uses of renamed pcvs faces - Tweak ChangeLog - Remove "-face" suffix from strokes-char face - Remove "-face" suffix from compare-windows face - Remove "-face" suffix from calendar faces - Remove "-face" suffix from diary-button face - Remove "-face" suffix from testcover faces - Remove "-face" suffix from viper faces - Remove "-face" suffix from org faces - Remove "-face" suffix from sgml-namespace face - Remove "-face" suffix from table-cell face - Remove "-face" suffix from tex-mode faces - Remove "-face" suffix from texinfo-heading face - Remove "-face" suffix from flyspell faces - Remove "-face" suffix from gomoku faces - Remove "-face" suffix from mpuz faces - Merge from gnus--rel--5.10 - Remove "-face" suffix from Buffer-menu-buffer face - Remove "-face" suffix from antlr-mode faces - Remove "-face" suffix from ebrowse faces - Remove "-face" suffix from flymake faces - Remove "-face" suffix from idlwave faces - Remove "-face" suffix from sh-script faces - Remove "-face" suffix from vhdl-mode faces - Remove "-face" suffix from which-func face - Remove "-face" suffix from cperl-mode faces - Remove "-face" suffix from ld-script faces - Fix cperl-mode font-lock problem - Tweak which-func face * gnus--rel--5.10 (patch 80-82) - Merge from emacs--cvs-trunk--0 - Update from CVS
Diffstat (limited to 'lispref/debugging.texi')
-rw-r--r--lispref/debugging.texi35
1 files changed, 18 insertions, 17 deletions
diff --git a/lispref/debugging.texi b/lispref/debugging.texi
index 07dfe18f283..739dd1fe298 100644
--- a/lispref/debugging.texi
+++ b/lispref/debugging.texi
@@ -118,8 +118,8 @@ the error. The easiest way is usually to set
118@end defopt 118@end defopt
119 119
120@defopt eval-expression-debug-on-error 120@defopt eval-expression-debug-on-error
121If you set this variable to a non-@code{nil} value, then 121If this variable has a non-@code{nil} value, then
122@code{debug-on-error} will be set to @code{t} when evaluating with the 122@code{debug-on-error} is set to @code{t} when evaluating with the
123command @code{eval-expression}. If 123command @code{eval-expression}. If
124@code{eval-expression-debug-on-error} is @code{nil}, then the value of 124@code{eval-expression-debug-on-error} is @code{nil}, then the value of
125@code{debug-on-error} is not changed. @xref{Lisp Eval,, Evaluating 125@code{debug-on-error} is not changed. @xref{Lisp Eval,, Evaluating
@@ -210,15 +210,19 @@ called shortly before the problem, step quickly over the call to that
210function, and then step through its caller. 210function, and then step through its caller.
211 211
212@deffn Command debug-on-entry function-name 212@deffn Command debug-on-entry function-name
213This function requests @var{function-name} to invoke the debugger each time 213This function requests @var{function-name} to invoke the debugger each
214it is called. It works by inserting the form @code{(debug 'debug)} into 214time it is called. It works by inserting the form
215the function definition as the first form. 215@code{(implement-debug-on-entry)} into the function definition as the
216 216first form.
217Any function defined as Lisp code may be set to break on entry, 217
218regardless of whether it is interpreted code or compiled code. If the 218Any function or macro defined as Lisp code may be set to break on
219function is a command, it will enter the debugger when called from Lisp 219entry, regardless of whether it is interpreted code or compiled code.
220and when called interactively (after the reading of the arguments). You 220If the function is a command, it will enter the debugger when called
221can't debug primitive functions (i.e., those written in C) this way. 221from Lisp and when called interactively (after the reading of the
222arguments). 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
224primitive is called from Lisp code. Debug-on-entry is not allowed for
225special forms.
222 226
223When @code{debug-on-entry} is called interactively, it prompts for 227When @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
@@ -267,16 +271,13 @@ Debugger entered--entering a function:
267@end example 271@end example
268@end deffn 272@end deffn
269 273
270@deffn Command cancel-debug-on-entry function-name 274@deffn Command cancel-debug-on-entry &optional function-name
271This function undoes the effect of @code{debug-on-entry} on 275This function undoes the effect of @code{debug-on-entry} on
272@var{function-name}. When called interactively, it prompts for 276@var{function-name}. When called interactively, it prompts for
273@var{function-name} in the minibuffer. If @var{function-name} is 277@var{function-name} in the minibuffer. If @var{function-name} is
274@code{nil} or the empty string, it cancels break-on-entry for all 278omitted or @code{nil}, it cancels break-on-entry for all functions.
275functions.
276
277Calling @code{cancel-debug-on-entry} does nothing to a function which is 279Calling @code{cancel-debug-on-entry} does nothing to a function which is
278not currently set up to break on entry. It always returns 280not currently set up to break on entry.
279@var{function-name}.
280@end deffn 281@end deffn
281 282
282@node Explicit Debug 283@node Explicit Debug