|
0
|
1 ;;; debug.el --- debuggers and related commands for XEmacs
|
|
|
2
|
|
|
3 ;; Copyright (C) 1985, 1986, 1993, 1994 Free Software Foundation, Inc.
|
|
|
4
|
|
|
5 ;; Maintainer: FSF
|
|
|
6 ;; Keyword: lisp, tools
|
|
|
7
|
|
|
8 ;; This file is part of XEmacs.
|
|
|
9
|
|
|
10 ;; XEmacs is free software; you can redistribute it and/or modify it
|
|
|
11 ;; under the terms of the GNU General Public License as published by
|
|
|
12 ;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
13 ;; any later version.
|
|
|
14
|
|
|
15 ;; XEmacs is distributed in the hope that it will be useful, but
|
|
|
16 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
18 ;; General Public License for more details.
|
|
|
19
|
|
|
20 ;; You should have received a copy of the GNU General Public License
|
|
|
21 ;; along with XEmacs; see the file COPYING. If not, write to the Free
|
|
4
|
22 ;; Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
|
|
|
23 ;; 02111-1307, USA.
|
|
|
24
|
|
|
25 ;;; Synched up with: FSF 19.34.
|
|
0
|
26
|
|
4
|
27 ;;; Commentary:
|
|
|
28
|
|
|
29 ;; NB: There are lots of formatting changes in the XEmacs version. -sb
|
|
|
30
|
|
|
31 ;; This is a major mode documented in the Emacs manual.
|
|
0
|
32
|
|
|
33 ;;; Code:
|
|
|
34
|
|
|
35 (defvar debug-function-list nil
|
|
|
36 "List of functions currently set for debug on entry.")
|
|
|
37
|
|
|
38 (defvar debugger-step-after-exit nil
|
|
|
39 "Non-nil means \"single-step\" after the debugger exits.")
|
|
|
40
|
|
|
41 (defvar debugger-value nil
|
|
|
42 "This is the value for the debugger to return, when it returns.")
|
|
|
43
|
|
|
44 (defvar debugger-old-buffer nil
|
|
|
45 "This is the buffer that was current when the debugger was entered.")
|
|
|
46
|
|
|
47 ;;#### This is terminally random an nigh-unmaintainable.
|
|
|
48 ;;#### (need progv in elisp...)
|
|
|
49 (defvar debugger-outer-match-data)
|
|
|
50 (defvar debugger-outer-load-read-function)
|
|
|
51 (defvar debugger-outer-overriding-local-map)
|
|
|
52 ;; FSFmacs (defvar debugger-outer-track-mouse)
|
|
|
53 (defvar debugger-outer-last-command)
|
|
|
54 (defvar debugger-outer-this-command)
|
|
|
55 (defvar debugger-outer-unread-command-event)
|
|
4
|
56 ;; FSF: (defvar debugger-outer-unread-command-char)
|
|
|
57 (defvar debugger-outer-unread-command-events)
|
|
0
|
58 (defvar debugger-outer-last-input-event)
|
|
|
59 (defvar debugger-outer-last-input-char)
|
|
|
60 (defvar debugger-outer-last-input-time)
|
|
|
61 (defvar debugger-outer-last-command-event)
|
|
4
|
62 ;; (defvar debugger-outer-last-nonmenu-event)
|
|
|
63 ;; (defvar debugger-outer-last-event-frame)
|
|
0
|
64 (defvar debugger-outer-last-command-char)
|
|
|
65 (defvar debugger-outer-standard-input)
|
|
|
66 (defvar debugger-outer-standard-output)
|
|
|
67 (defvar debugger-outer-cursor-in-echo-area)
|
|
|
68
|
|
|
69 ;;;don't ###autoload, loadup.el does something smarter.
|
|
|
70 (setq debugger 'debug)
|
|
|
71
|
|
|
72 (defvar debugger-step-after-exit)
|
|
|
73 (defvar debugger-old-buffer)
|
|
|
74 (defvar debugger-value)
|
|
|
75
|
|
|
76 ;;;###autoload
|
|
|
77 (defun debug (&rest debugger-args)
|
|
|
78 "Enter debugger. To return, type \\<debugger-mode-map>`\\[debugger-continue]'.
|
|
4
|
79 Arguments are mainly for use when this is called from the internals
|
|
|
80 of the evaluator.
|
|
|
81
|
|
|
82 You may call with no args, or you may pass nil as the first arg and
|
|
|
83 any other args you like. In that case, the list of args after the
|
|
|
84 first will be printed into the backtrace buffer."
|
|
0
|
85 (interactive)
|
|
|
86 ;; XEmacs: it doesn't work to enter the debugger non-interactively
|
|
|
87 ;; so just print out a backtrace and exit.
|
|
|
88 (if (noninteractive) (apply 'early-error-handler debugger-args))
|
|
|
89 (message "Entering debugger...")
|
|
|
90 (let (debugger-value
|
|
|
91 (debug-on-error nil)
|
|
|
92 (debug-on-quit nil)
|
|
4
|
93 (debug-on-signal nil) ; XEmacs
|
|
0
|
94 (debugger-buffer (let ((default-major-mode 'fundamental-mode))
|
|
|
95 (get-buffer-create "*Backtrace*")))
|
|
|
96 ;; #### I18N3 set the debugger-buffer to output-translating
|
|
|
97 (debugger-old-buffer (current-buffer))
|
|
|
98 (debugger-step-after-exit nil)
|
|
4
|
99 ;; Don't keep reading from an executing kbd macro!
|
|
|
100 (executing-macro nil)
|
|
|
101 ;; Save the outer values of these vars for the `e' command
|
|
0
|
102 ;; before we replace the values.
|
|
|
103 (debugger-outer-match-data (match-data))
|
|
|
104 (debugger-outer-load-read-function load-read-function)
|
|
|
105 (debugger-outer-overriding-local-map overriding-local-map)
|
|
|
106 ;; FSFmacs (debugger-outer-track-mouse track-mouse)
|
|
4
|
107 (debugger-outer-last-command last-command)
|
|
|
108 (debugger-outer-this-command this-command)
|
|
|
109 (debugger-outer-unread-command-event unread-command-event)
|
|
|
110 (debugger-outer-unread-command-events unread-command-events)
|
|
|
111 (debugger-outer-last-input-event last-input-event)
|
|
|
112 (debugger-outer-last-input-char last-input-char)
|
|
|
113 (debugger-outer-last-input-time last-input-time)
|
|
|
114 (debugger-outer-last-command-event last-command-event)
|
|
|
115 (debugger-outer-last-command-char last-command-char)
|
|
|
116 (debugger-outer-standard-input standard-input)
|
|
|
117 (debugger-outer-standard-output standard-output)
|
|
|
118 (debugger-outer-cursor-in-echo-area cursor-in-echo-area))
|
|
0
|
119 ;; Don't let these magic variables affect the debugger itself.
|
|
|
120 (unwind-protect ;XEmacs change
|
|
|
121 (let ((last-command nil)
|
|
|
122 (this-command nil)
|
|
|
123 (unread-command-event nil)
|
|
|
124 (last-input-event (allocate-event))
|
|
|
125 (last-input-char -1)
|
|
|
126 (last-input-time nil)
|
|
|
127 (last-command-event (allocate-event))
|
|
|
128 (last-command-char -1)
|
|
|
129 overriding-local-map
|
|
|
130 load-read-function
|
|
|
131 (standard-input t)
|
|
|
132 (standard-output t)
|
|
|
133 (cursor-in-echo-area nil))
|
|
|
134 (save-excursion
|
|
|
135 (save-window-excursion
|
|
|
136 (pop-to-buffer debugger-buffer)
|
|
|
137 (erase-buffer)
|
|
|
138 (let ((standard-output (current-buffer))
|
|
|
139 (print-escape-newlines t)
|
|
|
140 (print-length 50))
|
|
|
141 (backtrace))
|
|
|
142 (goto-char (point-min))
|
|
|
143 (debugger-mode)
|
|
|
144 (delete-region (point)
|
|
|
145 (progn
|
|
4
|
146 ;; XEmacs change
|
|
0
|
147 (re-search-forward "\n[* ] debug(")
|
|
|
148 (forward-line 1)
|
|
|
149 (point)))
|
|
4
|
150 (debugger-reenable)
|
|
0
|
151 ;; lambda is for debug-on-call when a function call is next.
|
|
|
152 ;; debug is for debug-on-entry function called.
|
|
|
153 (cond ((memq (car debugger-args) '(lambda debug))
|
|
|
154 (insert "Entering:\n")
|
|
|
155 (if (eq (car debugger-args) 'debug)
|
|
|
156 (progn
|
|
|
157 ;; Skip the frames for backtrace-debug, byte-code,
|
|
|
158 ;; and debug.
|
|
|
159 (backtrace-debug 3 t)
|
|
|
160 (delete-char 1)
|
|
|
161 (insert ?*)
|
|
|
162 (beginning-of-line))))
|
|
|
163 ;; Exiting a function.
|
|
|
164 ((eq (car debugger-args) 'exit)
|
|
|
165 (insert "Return value: ")
|
|
|
166 (setq debugger-value (nth 1 debugger-args))
|
|
|
167 (prin1 debugger-value (current-buffer))
|
|
|
168 (insert ?\n)
|
|
|
169 (delete-char 1)
|
|
|
170 (insert ? )
|
|
|
171 (beginning-of-line))
|
|
|
172 ;; Debugger entered for an error.
|
|
|
173 ((eq (car debugger-args) 'error)
|
|
4
|
174 (insert "Signaling: ")
|
|
0
|
175 (prin1 (nth 1 debugger-args) (current-buffer))
|
|
|
176 (insert ?\n))
|
|
|
177 ;; debug-on-call, when the next thing is an eval.
|
|
|
178 ((eq (car debugger-args) t)
|
|
4
|
179 (insert "Beginning evaluation of function call form:\n"))
|
|
0
|
180 ;; User calls debug directly.
|
|
|
181 (t
|
|
|
182 (prin1 (if (eq (car debugger-args) 'nil)
|
|
|
183 (cdr debugger-args) debugger-args)
|
|
|
184 (current-buffer))
|
|
|
185 (insert ?\n)))
|
|
|
186 (message "")
|
|
|
187 (let ((inhibit-trace t)
|
|
|
188 (standard-output nil)
|
|
|
189 (buffer-read-only t))
|
|
4
|
190 (message "")
|
|
0
|
191 (recursive-edit)))
|
|
4
|
192 ;; XEmacs change
|
|
0
|
193 debugger-value))
|
|
4
|
194 ;; Kill or at least neuter the backtrace buffer, so that users
|
|
|
195 ;; don't try to execute debugger commands in an invalid context.
|
|
0
|
196 (if (get-buffer-window debugger-buffer 'visible)
|
|
|
197 ;; Still visible despite the save-window-excursion? Maybe it
|
|
|
198 ;; it's in a pop-up frame. It would be annoying to delete and
|
|
|
199 ;; recreate it every time the debugger stops, so instead we'll
|
|
|
200 ;; erase it but leave it visible.
|
|
|
201 (save-excursion
|
|
|
202 (set-buffer debugger-buffer)
|
|
|
203 (erase-buffer)
|
|
|
204 (fundamental-mode))
|
|
|
205 (kill-buffer debugger-buffer))
|
|
|
206 (store-match-data debugger-outer-match-data)
|
|
|
207 ;; Put into effect the modified values of these variables
|
|
|
208 ;; in case the user set them with the `e' command.
|
|
|
209 (setq load-read-function debugger-outer-load-read-function)
|
|
|
210 (setq overriding-local-map debugger-outer-overriding-local-map)
|
|
|
211 ;; FSFmacs (setq track-mouse debugger-outer-track-mouse)
|
|
|
212 (setq last-command debugger-outer-last-command)
|
|
|
213 (setq this-command debugger-outer-this-command)
|
|
|
214 (setq unread-command-event debugger-outer-unread-command-event)
|
|
4
|
215 (setq unread-command-event debugger-outer-unread-command-events)
|
|
0
|
216 (setq last-input-event debugger-outer-last-input-event)
|
|
|
217 (setq last-input-char debugger-outer-last-input-char)
|
|
|
218 (setq last-input-time debugger-outer-last-input-time)
|
|
|
219 (setq last-command-event debugger-outer-last-command-event)
|
|
|
220 (setq last-command-char debugger-outer-last-command-char)
|
|
|
221 (setq standard-input debugger-outer-standard-input)
|
|
|
222 (setq standard-output debugger-outer-standard-output)
|
|
|
223 (setq cursor-in-echo-area debugger-outer-cursor-in-echo-area)
|
|
|
224 (setq debug-on-next-call debugger-step-after-exit) ;do this last!
|
|
|
225 )))
|
|
|
226
|
|
4
|
227 ;; XEmacs
|
|
0
|
228 (defun debugger-exit ()
|
|
|
229 (condition-case nil
|
|
|
230 (let ((debug-on-error nil)
|
|
|
231 (debug-on-signal nil))
|
|
|
232 ;; Tell signal to keep searching for handlers
|
|
|
233 (throw 'debugger t))
|
|
|
234 ;; Called from an old version of Emacs, perhaps?
|
|
|
235 (no-catch (exit-recursive-edit))))
|
|
|
236
|
|
|
237
|
|
|
238 (defun debugger-step-through ()
|
|
|
239 "Proceed, stepping through subexpressions of this expression.
|
|
|
240 Enter another debugger on next entry to eval, apply or funcall."
|
|
|
241 (interactive)
|
|
|
242 (setq debugger-step-after-exit t)
|
|
|
243 (message "Proceeding, will debug on next eval or call.")
|
|
4
|
244 ;; XEmacs
|
|
0
|
245 (debugger-exit))
|
|
|
246
|
|
|
247 (defun debugger-continue ()
|
|
|
248 "Continue, evaluating this expression without stopping."
|
|
|
249 (interactive)
|
|
|
250 (message "Continuing.")
|
|
4
|
251 ;; XEmacs
|
|
0
|
252 (debugger-exit))
|
|
|
253
|
|
|
254 (defun debugger-return-value (val)
|
|
|
255 "Continue, specifying value to return.
|
|
|
256 This is only useful when the value returned from the debugger
|
|
|
257 will be used, such as in a debug on exit from a frame."
|
|
|
258 (interactive "XReturn value (evaluated): ")
|
|
|
259 (setq debugger-value val)
|
|
|
260 (princ "Returning " t)
|
|
|
261 (prin1 debugger-value)
|
|
|
262 (exit-recursive-edit))
|
|
|
263
|
|
4
|
264 ;; XEmacs: [Moved block]
|
|
0
|
265 ;; Chosen empirically to account for all the frames
|
|
|
266 ;; that will exist when debugger-frame is called
|
|
|
267 ;; within the first one that appears in the backtrace buffer.
|
|
|
268 ;; Assumes debugger-frame is called from a key;
|
|
|
269 ;; will be wrong if it is called with Meta-x.
|
|
|
270 (defconst debugger-frame-offset 8 "")
|
|
|
271
|
|
|
272 (defun debugger-jump ()
|
|
|
273 "Continue to exit from this frame, with all debug-on-entry suspended."
|
|
|
274 (interactive)
|
|
|
275 ;; Compensate for the two extra stack frames for debugger-jump.
|
|
|
276 (let ((debugger-frame-offset (+ debugger-frame-offset 2)))
|
|
|
277 (debugger-frame))
|
|
|
278 ;; Turn off all debug-on-entry functions
|
|
|
279 ;; but leave them in the list.
|
|
|
280 (let ((list debug-function-list))
|
|
|
281 (while list
|
|
|
282 (fset (car list)
|
|
|
283 (debug-on-entry-1 (car list) (symbol-function (car list)) nil))
|
|
|
284 (setq list (cdr list))))
|
|
|
285 (message "Continuing through this frame")
|
|
|
286 (debugger-exit))
|
|
|
287
|
|
|
288 (defun debugger-reenable ()
|
|
|
289 "Turn all debug-on-entry functions back on."
|
|
|
290 (let ((list debug-function-list))
|
|
|
291 (while list
|
|
|
292 (or (consp (symbol-function (car list)))
|
|
|
293 (debug-convert-byte-code (car list)))
|
|
|
294 (fset (car list)
|
|
|
295 (debug-on-entry-1 (car list) (symbol-function (car list)) t))
|
|
|
296 (setq list (cdr list)))))
|
|
|
297
|
|
|
298 (defun debugger-frame-number ()
|
|
|
299 "Return number of frames in backtrace before the one point points at."
|
|
|
300 (save-excursion
|
|
|
301 (beginning-of-line)
|
|
|
302 (let ((opoint (point))
|
|
|
303 (count 0))
|
|
|
304 (goto-char (point-min))
|
|
4
|
305 ;; XEmacs:#### I18N3 will not localize properly!
|
|
0
|
306 (if (or (equal (buffer-substring (point) (+ (point) 6))
|
|
|
307 (gettext "Signal"))
|
|
|
308 (equal (buffer-substring (point) (+ (point) 6))
|
|
|
309 (gettext "Return")))
|
|
|
310 (progn
|
|
|
311 (search-forward ":")
|
|
|
312 (forward-sexp 1)))
|
|
|
313 (forward-line 1)
|
|
|
314 (while (progn
|
|
|
315 (forward-char 2)
|
|
|
316 (if (= (following-char) ?\()
|
|
|
317 (forward-sexp 1)
|
|
|
318 (forward-sexp 2))
|
|
|
319 (forward-line 1)
|
|
|
320 (<= (point) opoint))
|
|
|
321 (setq count (1+ count)))
|
|
|
322 count)))
|
|
|
323
|
|
|
324 (defun debugger-frame ()
|
|
|
325 "Request entry to debugger when this frame exits.
|
|
|
326 Applies to the frame whose line point is on in the backtrace."
|
|
|
327 (interactive)
|
|
|
328 (beginning-of-line)
|
|
|
329 (let ((level (debugger-frame-number)))
|
|
|
330 (backtrace-debug (+ level debugger-frame-offset) t))
|
|
|
331 (if (= (following-char) ? )
|
|
|
332 (let ((buffer-read-only nil))
|
|
|
333 (delete-char 1)
|
|
|
334 (insert ?*)))
|
|
|
335 (beginning-of-line))
|
|
|
336
|
|
|
337 (defun debugger-frame-clear ()
|
|
|
338 "Do not enter to debugger when this frame exits.
|
|
|
339 Applies to the frame whose line point is on in the backtrace."
|
|
|
340 (interactive)
|
|
|
341 (beginning-of-line)
|
|
|
342 (let ((level (debugger-frame-number)))
|
|
|
343 (backtrace-debug (+ level debugger-frame-offset) nil))
|
|
|
344 (if (= (following-char) ?*)
|
|
|
345 (let ((buffer-read-only nil))
|
|
|
346 (delete-char 1)
|
|
|
347 (insert ? )))
|
|
|
348 (beginning-of-line))
|
|
|
349
|
|
|
350 (defun debugger-eval-expression (debugger-exp)
|
|
|
351 "Eval an expression, in an environment like that outside the debugger."
|
|
|
352 (interactive
|
|
|
353 (list (read-from-minibuffer "Eval: "
|
|
|
354 nil read-expression-map t
|
|
|
355 'read-expression-history)))
|
|
|
356 (save-excursion
|
|
|
357 (if (null (buffer-name debugger-old-buffer))
|
|
|
358 ;; old buffer deleted
|
|
|
359 (setq debugger-old-buffer (current-buffer)))
|
|
|
360 (set-buffer debugger-old-buffer)
|
|
|
361 (let ((last-command debugger-outer-last-command)
|
|
4
|
362 (this-command debugger-outer-this-command)
|
|
|
363 (unread-command-event debugger-outer-unread-command-event)
|
|
|
364 (unread-command-event debugger-outer-unread-command-events)
|
|
|
365 (last-input-event debugger-outer-last-input-event)
|
|
|
366 (last-input-char debugger-outer-last-input-char)
|
|
|
367 (last-input-time debugger-outer-last-input-time)
|
|
|
368 (last-command-event debugger-outer-last-command-event)
|
|
|
369 (last-command-char debugger-outer-last-command-char)
|
|
|
370 (standard-input debugger-outer-standard-input)
|
|
|
371 (standard-output debugger-outer-standard-output)
|
|
0
|
372 (cursor-in-echo-area debugger-outer-cursor-in-echo-area)
|
|
|
373 (overriding-local-map debugger-outer-overriding-local-map)
|
|
|
374 (load-read-function debugger-outer-load-read-function))
|
|
|
375 (store-match-data debugger-outer-match-data)
|
|
|
376 (prog1 (eval-expression debugger-exp)
|
|
|
377 (setq debugger-outer-match-data (match-data)
|
|
|
378 debugger-outer-load-read-function load-read-function
|
|
|
379 debugger-outer-overriding-local-map overriding-local-map
|
|
|
380 debugger-outer-last-command last-command
|
|
|
381 debugger-outer-this-command this-command
|
|
|
382 debugger-outer-unread-command-event unread-command-event
|
|
|
383 debugger-outer-last-input-event last-input-event
|
|
|
384 debugger-outer-last-input-char last-input-char
|
|
|
385 debugger-outer-last-input-time last-input-time
|
|
|
386 debugger-outer-last-command-event last-command-event
|
|
|
387 debugger-outer-last-command-char last-command-char
|
|
|
388 debugger-outer-standard-input standard-input
|
|
|
389 debugger-outer-standard-output standard-output
|
|
|
390 debugger-outer-cursor-in-echo-area cursor-in-echo-area)))))
|
|
|
391
|
|
4
|
392 (defvar debugger-mode-map nil)
|
|
|
393 (if debugger-mode-map
|
|
|
394 nil
|
|
|
395 (let ((loop ? ))
|
|
|
396 (setq debugger-mode-map (make-keymap))
|
|
|
397 (suppress-keymap debugger-mode-map)
|
|
|
398 (define-key debugger-mode-map "-" 'negative-argument)
|
|
|
399 (define-key debugger-mode-map "b" 'debugger-frame)
|
|
|
400 (define-key debugger-mode-map "c" 'debugger-continue)
|
|
|
401 (define-key debugger-mode-map "j" 'debugger-jump)
|
|
|
402 (define-key debugger-mode-map "r" 'debugger-return-value)
|
|
|
403 (define-key debugger-mode-map "u" 'debugger-frame-clear)
|
|
|
404 (define-key debugger-mode-map "d" 'debugger-step-through)
|
|
|
405 (define-key debugger-mode-map "l" 'debugger-list-functions)
|
|
|
406 (define-key debugger-mode-map "h" 'describe-mode)
|
|
|
407 (define-key debugger-mode-map "q" 'top-level)
|
|
|
408 (define-key debugger-mode-map "e" 'debugger-eval-expression)
|
|
|
409 (define-key debugger-mode-map " " 'next-line)))
|
|
0
|
410
|
|
|
411 (put 'debugger-mode 'mode-class 'special)
|
|
|
412
|
|
|
413 (defun debugger-mode ()
|
|
|
414 "Mode for backtrace buffers, selected in debugger.
|
|
|
415 \\<debugger-mode-map>
|
|
|
416 A line starts with `*' if exiting that frame will call the debugger.
|
|
|
417 Type \\[debugger-frame] or \\[debugger-frame-clear] to set or remove the `*'.
|
|
|
418
|
|
|
419 When in debugger due to frame being exited,
|
|
|
420 use the \\[debugger-return-value] command to override the value
|
|
|
421 being returned from that frame.
|
|
|
422
|
|
|
423 Use \\[debug-on-entry] and \\[cancel-debug-on-entry] to control
|
|
|
424 which functions will enter the debugger when called.
|
|
|
425
|
|
|
426 Complete list of commands:
|
|
|
427 \\{debugger-mode-map}"
|
|
|
428 (kill-all-local-variables)
|
|
|
429 (setq major-mode 'debugger-mode)
|
|
4
|
430 (setq mode-name (gettext "Debugger")) ; XEmacs
|
|
0
|
431 (setq truncate-lines t)
|
|
|
432 (set-syntax-table emacs-lisp-mode-syntax-table)
|
|
|
433 (use-local-map debugger-mode-map))
|
|
|
434
|
|
|
435 ;;;###autoload
|
|
|
436 (defun debug-on-entry (function)
|
|
|
437 "Request FUNCTION to invoke debugger each time it is called.
|
|
|
438 If you tell the debugger to continue, FUNCTION's execution proceeds.
|
|
|
439 This works by modifying the definition of FUNCTION,
|
|
|
440 which must be written in Lisp, not predefined.
|
|
|
441 Use \\[cancel-debug-on-entry] to cancel the effect of this command.
|
|
|
442 Redefining FUNCTION also cancels it."
|
|
|
443 (interactive "aDebug on entry (to function): ")
|
|
|
444 (debugger-reenable)
|
|
|
445 (if (subrp (symbol-function function))
|
|
|
446 (error "Function %s is a primitive" function))
|
|
|
447 (or (consp (symbol-function function))
|
|
|
448 (debug-convert-byte-code function))
|
|
|
449 (or (consp (symbol-function function))
|
|
|
450 (error "Definition of %s is not a list" function))
|
|
|
451 (fset function (debug-on-entry-1 function (symbol-function function) t))
|
|
|
452 (or (memq function debug-function-list)
|
|
|
453 (setq debug-function-list (cons function debug-function-list)))
|
|
|
454 function)
|
|
|
455
|
|
|
456 ;;;###autoload
|
|
|
457 (defun cancel-debug-on-entry (&optional function)
|
|
|
458 "Undo effect of \\[debug-on-entry] on FUNCTION.
|
|
|
459 If argument is nil or an empty string, cancel for all functions."
|
|
|
460 (interactive
|
|
|
461 (list (let ((name
|
|
4
|
462 (completing-read "Cancel debug on entry (to function): "
|
|
|
463 ;; Make an "alist" of the functions
|
|
0
|
464 ;; that now have debug on entry.
|
|
4
|
465 (mapcar 'list
|
|
|
466 (mapcar 'symbol-name
|
|
|
467 debug-function-list))
|
|
0
|
468 nil t nil)))
|
|
|
469 (if name (intern name)))))
|
|
|
470 (debugger-reenable)
|
|
|
471 (if (and function (not (string= function "")))
|
|
|
472 (progn
|
|
|
473 (fset function
|
|
|
474 (debug-on-entry-1 function (symbol-function function) nil))
|
|
|
475 (setq debug-function-list (delq function debug-function-list))
|
|
|
476 function)
|
|
|
477 (message "Cancelling debug-on-entry for all functions")
|
|
|
478 (mapcar 'cancel-debug-on-entry debug-function-list)))
|
|
|
479
|
|
|
480 (defun debug-convert-byte-code (function)
|
|
|
481 (let ((defn (symbol-function function)))
|
|
|
482 (if (not (consp defn))
|
|
|
483 ;; Assume a compiled code object.
|
|
|
484 (let* ((contents (append defn nil))
|
|
|
485 (body
|
|
|
486 (list (list 'byte-code (nth 1 contents)
|
|
|
487 (nth 2 contents) (nth 3 contents)))))
|
|
|
488 (if (nthcdr 5 contents)
|
|
|
489 (setq body (cons (list 'interactive (nth 5 contents)) body)))
|
|
|
490 (if (nth 4 contents)
|
|
|
491 ;; Use `documentation' here, to get the actual string,
|
|
|
492 ;; in case the compiled function has a reference
|
|
|
493 ;; to the .elc file.
|
|
|
494 (setq body (cons (documentation function) body)))
|
|
|
495 (fset function (cons 'lambda (cons (car contents) body)))))))
|
|
|
496
|
|
|
497 (defun debug-on-entry-1 (function defn flag)
|
|
|
498 (if (subrp defn)
|
|
|
499 (error "%s is a built-in function" function)
|
|
|
500 (if (eq (car defn) 'macro)
|
|
|
501 (debug-on-entry-1 function (cdr defn) flag)
|
|
|
502 (or (eq (car defn) 'lambda)
|
|
|
503 (error "%s not user-defined Lisp function" function))
|
|
|
504 (let (tail prec)
|
|
|
505 (if (stringp (car (nthcdr 2 defn)))
|
|
|
506 (setq tail (nthcdr 3 defn)
|
|
4
|
507 prec (list (car defn) (car (cdr defn))
|
|
|
508 (car (cdr (cdr defn)))))
|
|
0
|
509 (setq tail (nthcdr 2 defn)
|
|
|
510 prec (list (car defn) (car (cdr defn)))))
|
|
|
511 (if (eq flag (equal (car tail) '(debug 'debug)))
|
|
|
512 defn
|
|
|
513 (if flag
|
|
|
514 (nconc prec (cons '(debug 'debug) tail))
|
|
|
515 (nconc prec (cdr tail))))))))
|
|
|
516
|
|
|
517 (defun debugger-list-functions ()
|
|
|
518 "Display a list of all the functions now set to debug on entry."
|
|
|
519 (interactive)
|
|
|
520 (with-output-to-temp-buffer "*Help*"
|
|
|
521 (if (null debug-function-list)
|
|
|
522 (princ "No debug-on-entry functions now\n")
|
|
|
523 (princ "Functions set to debug on entry:\n\n")
|
|
|
524 (let ((list debug-function-list))
|
|
|
525 (while list
|
|
|
526 (prin1 (car list))
|
|
|
527 (terpri)
|
|
|
528 (setq list (cdr list))))
|
|
|
529 (princ "Note: if you have redefined a function, then it may no longer\n")
|
|
|
530 (princ "be set to debug on entry, even if it is in the list."))
|
|
|
531 (save-excursion
|
|
|
532 (set-buffer standard-output)
|
|
|
533 (help-mode))))
|
|
|
534
|
|
|
535 ;;; debug.el ends here
|
