aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/debugging.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lispref/debugging.texi')
-rw-r--r--doc/lispref/debugging.texi11
1 files changed, 5 insertions, 6 deletions
diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi
index 6e7d0078e07..3c446b07f60 100644
--- a/doc/lispref/debugging.texi
+++ b/doc/lispref/debugging.texi
@@ -2,7 +2,6 @@
2@c This is part of the GNU Emacs Lisp Reference Manual. 2@c This is part of the GNU Emacs Lisp Reference Manual.
3@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc. 3@c Copyright (C) 1990-1994, 1998-1999, 2001-2012 Free Software Foundation, Inc.
4@c See the file elisp.texi for copying conditions. 4@c See the file elisp.texi for copying conditions.
5@setfilename ../../info/debugging
6@node Debugging, Read and Print, Advising Functions, Top 5@node Debugging, Read and Print, Advising Functions, Top
7@chapter Debugging Lisp Programs 6@chapter Debugging Lisp Programs
8 7
@@ -303,7 +302,7 @@ an implicit @code{progn} (@pxref{Sequencing}).
303@subsection Using the Debugger 302@subsection Using the Debugger
304 303
305 When the debugger is entered, it displays the previously selected 304 When the debugger is entered, it displays the previously selected
306buffer in one window and a buffer named @samp{*Backtrace*} in another 305buffer in one window and a buffer named @file{*Backtrace*} in another
307window. The backtrace buffer contains one line for each level of Lisp 306window. The backtrace buffer contains one line for each level of Lisp
308function execution currently going on. At the beginning of this buffer 307function execution currently going on. At the beginning of this buffer
309is a message describing the reason that the debugger was invoked (such 308is a message describing the reason that the debugger was invoked (such
@@ -412,7 +411,7 @@ the variable values within the debugger.
412 411
413@item R 412@item R
414Like @kbd{e}, but also save the result of evaluation in the 413Like @kbd{e}, but also save the result of evaluation in the
415buffer @samp{*Debugger-record*}. 414buffer @file{*Debugger-record*}.
416 415
417@item q 416@item q
418Terminate the program being debugged; return to top-level Emacs 417Terminate the program being debugged; return to top-level Emacs
@@ -450,7 +449,7 @@ to invoke the debugger.
450 449
451@defun debug &rest debugger-args 450@defun debug &rest debugger-args
452This function enters the debugger. It switches buffers to a buffer 451This function enters the debugger. It switches buffers to a buffer
453named @samp{*Backtrace*} (or @samp{*Backtrace*<2>} if it is the second 452named @file{*Backtrace*} (or @file{*Backtrace*<2>} if it is the second
454recursive entry to the debugger, etc.), and fills it with information 453recursive entry to the debugger, etc.), and fills it with information
455about the stack of Lisp function calls. It then enters a recursive 454about the stack of Lisp function calls. It then enters a recursive
456edit, showing the backtrace buffer in Debugger mode. 455edit, showing the backtrace buffer in Debugger mode.
@@ -461,7 +460,7 @@ buffer and returns to whatever called @code{debug}. This is the only
461way the function @code{debug} can return to its caller. 460way the function @code{debug} can return to its caller.
462 461
463The use of the @var{debugger-args} is that @code{debug} displays the 462The use of the @var{debugger-args} is that @code{debug} displays the
464rest of its arguments at the top of the @samp{*Backtrace*} buffer, so 463rest of its arguments at the top of the @file{*Backtrace*} buffer, so
465that the user can see them. Except as described below, this is the 464that the user can see them. Except as described below, this is the
466@emph{only} way these arguments are used. 465@emph{only} way these arguments are used.
467 466
@@ -560,7 +559,7 @@ of @code{debug} (@pxref{Invoking the Debugger}).
560@cindex call stack 559@cindex call stack
561This function prints a trace of Lisp function calls currently active. 560This function prints a trace of Lisp function calls currently active.
562This is the function used by @code{debug} to fill up the 561This is the function used by @code{debug} to fill up the
563@samp{*Backtrace*} buffer. It is written in C, since it must have access 562@file{*Backtrace*} buffer. It is written in C, since it must have access
564to the stack to determine which function calls are active. The return 563to the stack to determine which function calls are active. The return
565value is always @code{nil}. 564value is always @code{nil}.
566 565