Mercurial > emacs
annotate lisp/emacs-lisp/trace.el @ 110523:a5ad4f188e19
Synch Semantic to CEDET 1.0.
Move CEDET ChangeLog entries to new file lisp/cedet/ChangeLog.
* semantic.el (semantic-version): Update to 2.0.
(semantic-mode-map): Add "," and "m" bindings.
(navigate-menu): Update.
* semantic/symref.el (semantic-symref-calculate-rootdir):
New function.
(semantic-symref-detect-symref-tool): Use it.
* semantic/symref/grep.el (semantic-symref-grep-shell): New var.
(semantic-symref-perform-search): Use it. Calculate root dir with
semantic-symref-calculate-rootdir.
(semantic-symref-derive-find-filepatterns): Improve error message.
* semantic/symref/list.el
(semantic-symref-results-mode-map): New bindings.
(semantic-symref-auto-expand-results): New option.
(semantic-symref-results-dump): Obey auto-expand.
(semantic-symref-list-expand-all, semantic-symref-regexp)
(semantic-symref-list-contract-all)
(semantic-symref-list-map-open-hits)
(semantic-symref-list-update-open-hits)
(semantic-symref-list-create-macro-on-open-hit)
(semantic-symref-list-call-macro-on-open-hits): New functions.
(semantic-symref-list-menu-entries)
(semantic-symref-list-menu): New vars.
(semantic-symref-list-map-open-hits): Move cursor to beginning of
match before calling the mapped function.
* semantic/doc.el
(semantic-documentation-comment-preceeding-tag): Do nothing if the
mode doesn't provide comment-start-skip.
* semantic/scope.el
(semantic-analyze-scope-nested-tags-default): Strip duplicates.
(semantic-analyze-scoped-inherited-tag-map): Take the tag we are
looking for as part of the scoped tags list.
* semantic/html.el (semantic-default-html-setup): Add
senator-step-at-tag-classes.
* semantic/decorate/include.el
(semantic-decoration-on-unknown-includes): Change light bgcolor.
(semantic-decoration-on-includes-highlight-default): Check that
the include tag has a postion.
* semantic/complete.el (semantic-collector-local-members):
(semantic-complete-read-tag-local-members)
(semantic-complete-jump-local-members): New class and functions.
(semantic-complete-self-insert): Save excursion before completing.
* semantic/analyze/complete.el
(semantic-analyze-possible-completions-default): If no completions
are found, return the raw by-name-only completion list. Add FLAGS
arguments. Add support for 'no-tc (type constraint) and
'no-unique, or no stripping duplicates.
(semantic-analyze-possible-completions-default): Add FLAGS arg.
* semantic/util-modes.el
(semantic-stickyfunc-show-only-functions-p): New option.
(semantic-stickyfunc-fetch-stickyline): Don't show stickytext for
the very first line in a buffer.
* semantic/util.el (semantic-hack-search)
(semantic-recursive-find-nonterminal-by-name)
(semantic-current-tag-interactive): Deleted.
(semantic-describe-buffer): Fix expand-nonterminal. Add
lex-syntax-mods, type relation separator char, and command
separation char.
(semantic-sanity-check): Only message if called interactively.
* semantic/tag.el (semantic-tag-deep-copy-one-tag): Copy the
:filename property and the tag position.
* semantic/lex-spp.el (semantic-lex-spp-lex-text-string):
Add recursion limit.
* semantic/imenu.el (semantic-imenu-bucketize-type-members):
Make this buffer local, not the obsoleted variable.
* semantic/idle.el: Add breadcrumbs support.
(semantic-idle-summary-current-symbol-info-default)
(semantic-idle-tag-highlight)
(semantic-idle-completion-list-default): Use
semanticdb-without-unloaded-file-searches for speed, and to
conform to the controls that specify if the idle timer is supposed
to be parsing unparsed includes.
(semantic-idle-symbol-highlight-face)
(semantic-idle-symbol-maybe-highlight): Rename from *-summary-*.
Callers changed.
(semantic-idle-work-parse-neighboring-files-flag): Default to nil.
(semantic-idle-work-update-headers-flag): New var.
(semantic-idle-work-for-one-buffer): Use it.
(semantic-idle-local-symbol-highlight): Rename from
semantic-idle-tag-highlight.
(semantic-idle-truncate-long-summaries): New option.
* semantic/ia.el (semantic-ia-cache)
(semantic-ia-get-completions): Deleted. Callers changed.
(semantic-ia-show-variants): New command.
(semantic-ia-show-doc): If doc is empty, don't make a temp buffer.
(semantic-ia-show-summary): If there isn't anything to show, say so.
* semantic/grammar.el (semantic-grammar-create-package):
Save the buffer even in batch mode.
* semantic/fw.el
(semanticdb-without-unloaded-file-searches): New macro.
* semantic/dep.el (semantic-dependency-find-file-on-path):
Fix case dereferencing ede-object when it is a list.
* semantic/db-typecache.el (semanticdb-expand-nested-tag)
(semanticdb-typecache-faux-namespace): New functions.
(semanticdb-typecache-file-tags)
(semanticdb-typecache-merge-streams): Use them.
(semanticdb-typecache-file-tags): When deriving tags from a file,
give the mode a chance to monkey with the tag copy.
(semanticdb-typecache-find-default): Wrap find in save-excursion.
(semanticdb-typecache-find-by-name-helper): Merge found names down.
* semantic/db-global.el
(semanticdb-enable-gnu-global-in-buffer): Don't show messages if
GNU Global is not available and we don't want to throw an error.
* semantic/db-find.el (semanticdb-find-result-nth-in-buffer):
When trying to normalize the tag to a buffer, don't error if
set-buffer method doesn't exist.
* semantic/db-file.el (semanticdb-save-db): Simplify msg.
* semantic/db.el (semanticdb-refresh-table): If forcing a
refresh on a file not in a buffer, use semantic-find-file-noselect
and delete the buffer after use.
(semanticdb-current-database-list): When calculating root via
hooks, force it through true-filename and skip the list of
possible roots.
* semantic/ctxt.el (semantic-ctxt-imported-packages): New.
* semantic/analyze/debug.el
(semantic-analyzer-debug-insert-tag): Reset standard output to
current buffer.
(semantic-analyzer-debug-global-symbol)
(semantic-analyzer-debug-missing-innertype): Change "prefix" to
"symbol" in messages.
* semantic/analyze/refs.el: (semantic-analyze-refs-impl)
(semantic-analyze-refs-proto): When calculating value, make sure
the found tag is 'similar' to the originating tag.
(semantic--analyze-refs-find-tags-with-parent): Attempt to
identify matches via imported symbols of parents.
(semantic--analyze-refs-full-lookup-with-parents): Do a deep
search during the brute search.
* semantic/analyze.el
(semantic-analyze-find-tag-sequence-default): Be robust to
calculated scopes being nil.
* semantic/bovine/c.el (semantic-c-describe-environment): Add
project macro symbol array.
(semantic-c-parse-lexical-token): Add recursion limit.
(semantic-ctxt-imported-packages, semanticdb-expand-nested-tag):
New overrides.
(semantic-expand-c-tag-namelist): Split a full type from a typedef
out to its own tag.
(semantic-expand-c-tag-namelist): Do not split out a typedef'd
inline type if it is an anonymous type.
(semantic-c-reconstitute-token): Use the optional initializers as
a clue that some function is probably a constructor. When
defining the type of these constructors, split the parent name,
and use only the class part, if applicable.
* semantic/bovine/c-by.el:
* semantic/wisent/python-wy.el: Regenerate.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Sat, 18 Sep 2010 22:49:54 -0400 |
parents | ed16fdd2685a |
children | 376148b31b5e |
rev | line source |
---|---|
2854 | 1 ;;; trace.el --- tracing facility for Emacs Lisp functions |
2 | |
74466 | 3 ;; Copyright (C) 1993, 1998, 2000, 2001, 2002, 2003, 2004, |
106815 | 4 ;; 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. |
2854 | 5 |
6 ;; Author: Hans Chalupsky <hans@cs.buffalo.edu> | |
28574
23e11bfcfc21
Change maintainer. Use new backquote
Dave Love <fx@gnu.org>
parents:
21365
diff
changeset
|
7 ;; Maintainer: FSF |
2854 | 8 ;; Created: 15 Dec 1992 |
5140 | 9 ;; Keywords: tools, lisp |
2854 | 10 |
11 ;; This file is part of GNU Emacs. | |
12 | |
94655
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94179
diff
changeset
|
13 ;; GNU Emacs is free software: you can redistribute it and/or modify |
2854 | 14 ;; it under the terms of the GNU General Public License as published by |
94655
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94179
diff
changeset
|
15 ;; the Free Software Foundation, either version 3 of the License, or |
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94179
diff
changeset
|
16 ;; (at your option) any later version. |
2854 | 17 |
18 ;; GNU Emacs is distributed in the hope that it will be useful, | |
19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
21 ;; GNU General Public License for more details. | |
22 | |
23 ;; You should have received a copy of the GNU General Public License | |
94655
90a2847062be
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94179
diff
changeset
|
24 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
2854 | 25 |
26 ;; LCD Archive Entry: | |
27 ;; trace|Hans Chalupsky|hans@cs.buffalo.edu| | |
28 ;; Tracing facility for Emacs Lisp functions| | |
29 ;; 1993/05/18 00:41:16|2.0|~/packages/trace.el.Z| | |
30 | |
31 | |
32 ;;; Commentary: | |
33 | |
34 ;; Introduction: | |
35 ;; ============= | |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
36 ;; A simple trace package that utilizes advice.el. It generates trace |
2854 | 37 ;; information in a Lisp-style fashion and inserts it into a trace output |
38 ;; buffer. Tracing can be done in the background (or silently) so that | |
39 ;; generation of trace output won't interfere with what you are currently | |
40 ;; doing. | |
41 | |
42 ;; Requirement: | |
43 ;; ============ | |
44 ;; trace.el needs advice.el version 2.0 or later which you can get from the | |
45 ;; same place from where you got trace.el. | |
46 | |
47 ;; Restrictions: | |
48 ;; ============= | |
49 ;; - Traced subrs when called interactively will always show nil as the | |
50 ;; value of their arguments. | |
51 ;; - Only functions/macros/subrs that are called via their function cell will | |
52 ;; generate trace output, hence, you won't get trace output for: | |
53 ;; + Subrs called directly from other subrs/C-code | |
54 ;; + Compiled calls to subrs that have special byte-codes associated | |
55 ;; with them (e.g., car, cdr, ...) | |
56 ;; + Macros that were expanded during compilation | |
57 ;; - All the restrictions that apply to advice.el | |
58 | |
59 ;; Installation: | |
60 ;; ============= | |
61 ;; Put this file together with advice.el (version 2.0 or later) somewhere | |
62 ;; into your Emacs `load-path', byte-compile it/them for efficiency, and | |
63 ;; put the following autoload declarations into your .emacs | |
64 ;; | |
65 ;; (autoload 'trace-function "trace" "Trace a function" t) | |
66 ;; (autoload 'trace-function-background "trace" "Trace a function" t) | |
67 ;; | |
68 ;; or explicitly load it with (require 'trace) or (load "trace"). | |
69 | |
70 ;; Usage: | |
71 ;; ====== | |
72 ;; - To trace a function say `M-x trace-function' which will ask you for the | |
73 ;; name of the function/subr/macro to trace, as well as for the buffer | |
74 ;; into which trace output should go. | |
75 ;; - If you want to trace a function that switches buffers or does other | |
76 ;; display oriented stuff use `M-x trace-function-background' which will | |
77 ;; generate the trace output silently in the background without popping | |
78 ;; up windows and doing other irritating stuff. | |
79 ;; - To untrace a function say `M-x untrace-function'. | |
80 ;; - To untrace all currently traced functions say `M-x untrace-all'. | |
81 | |
82 ;; Examples: | |
83 ;; ========= | |
84 ;; | |
85 ;; (defun fact (n) | |
86 ;; (if (= n 0) 1 | |
87 ;; (* n (fact (1- n))))) | |
88 ;; fact | |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
89 ;; |
2854 | 90 ;; (trace-function 'fact) |
91 ;; fact | |
92 ;; | |
93 ;; Now, evaluating this... | |
94 ;; | |
95 ;; (fact 4) | |
96 ;; 24 | |
97 ;; | |
98 ;; ...will generate the following in *trace-buffer*: | |
99 ;; | |
100 ;; 1 -> fact: n=4 | |
101 ;; | 2 -> fact: n=3 | |
102 ;; | | 3 -> fact: n=2 | |
103 ;; | | | 4 -> fact: n=1 | |
104 ;; | | | | 5 -> fact: n=0 | |
105 ;; | | | | 5 <- fact: 1 | |
106 ;; | | | 4 <- fact: 1 | |
107 ;; | | 3 <- fact: 2 | |
108 ;; | 2 <- fact: 6 | |
109 ;; 1 <- fact: 24 | |
110 ;; | |
111 ;; | |
112 ;; (defun ack (x y z) | |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
113 ;; (if (= x 0) |
2854 | 114 ;; (+ y z) |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
115 ;; (if (and (<= x 2) (= z 0)) |
2854 | 116 ;; (1- x) |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
117 ;; (if (and (> x 2) (= z 0)) |
2854 | 118 ;; y |
119 ;; (ack (1- x) y (ack x y (1- z))))))) | |
120 ;; ack | |
121 ;; | |
122 ;; (trace-function 'ack) | |
123 ;; ack | |
124 ;; | |
125 ;; Try this for some interesting trace output: | |
126 ;; | |
127 ;; (ack 3 3 1) | |
128 ;; 27 | |
129 ;; | |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
130 ;; |
2854 | 131 ;; The following does something similar to the functionality of the package |
132 ;; log-message.el by Robert Potter, which is giving you a chance to look at | |
133 ;; messages that might have whizzed by too quickly (you won't see subr | |
134 ;; generated messages though): | |
135 ;; | |
136 ;; (trace-function-background 'message "*Message Log*") | |
137 | |
138 | |
139 ;;; Change Log: | |
140 | |
141 ;; Revision 2.0 1993/05/18 00:41:16 hans | |
142 ;; * Adapted for advice.el 2.0; it now also works | |
143 ;; for GNU Emacs-19 and Lemacs | |
144 ;; * Separate function `trace-function-background' | |
145 ;; * Separate pieces of advice for foreground and background tracing | |
146 ;; * Less insane handling of interactive trace buffer specification | |
147 ;; * String arguments and values are now printed properly | |
148 ;; | |
149 ;; Revision 1.1 1992/12/15 22:45:15 hans | |
150 ;; * Created, first public release | |
151 | |
152 | |
153 ;;; Code: | |
154 | |
155 (require 'advice) | |
156 | |
21365 | 157 (defgroup trace nil |
64032
85b597997ef0
(trace): Finish `defgroup' description with period.
Juanma Barranquero <lekktu@gmail.com>
parents:
60276
diff
changeset
|
158 "Tracing facility for Emacs Lisp functions." |
21365 | 159 :prefix "trace-" |
160 :group 'lisp) | |
161 | |
2854 | 162 ;;;###autoload |
105870
26baacb565b0
* textmodes/tex-mode.el (tex-alt-dvi-print-command)
Dan Nicolaescu <dann@ics.uci.edu>
parents:
104024
diff
changeset
|
163 (defcustom trace-buffer (purecopy "*trace-output*") |
104024
cce8d50c4566
Remove leading * from defcustom docs.
Glenn Morris <rgm@gnu.org>
parents:
100908
diff
changeset
|
164 "Trace output will by default go to that buffer." |
21365 | 165 :type 'string |
166 :group 'trace) | |
2854 | 167 |
168 ;; Current level of traced function invocation: | |
169 (defvar trace-level 0) | |
170 | |
171 ;; Semi-cryptic name used for a piece of trace advice: | |
172 (defvar trace-advice-name 'trace-function\ ) | |
173 | |
174 ;; Used to separate new trace output from previous traced runs: | |
175 (defvar trace-separator (format "%s\n" (make-string 70 ?=))) | |
176 | |
60276
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
177 (defvar inhibit-trace nil |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
178 "If non-nil, all tracing is temporarily inhibited.") |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
179 |
2854 | 180 (defun trace-entry-message (function level argument-bindings) |
181 ;; Generates a string that describes that FUNCTION has been entered at | |
182 ;; trace LEVEL with ARGUMENT-BINDINGS. | |
183 (format "%s%s%d -> %s: %s\n" | |
184 (mapconcat 'char-to-string (make-string (1- level) ?|) " ") | |
185 (if (> level 1) " " "") | |
186 level | |
187 function | |
95577
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
188 (let ((print-circle t)) |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
189 (mapconcat (lambda (binding) |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
190 (concat |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
191 (symbol-name (ad-arg-binding-field binding 'name)) |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
192 "=" |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
193 ;; do this so we'll see strings: |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
194 (prin1-to-string |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
195 (ad-arg-binding-field binding 'value)))) |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
196 argument-bindings |
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
197 " ")))) |
2854 | 198 |
199 (defun trace-exit-message (function level value) | |
200 ;; Generates a string that describes that FUNCTION has been exited at | |
201 ;; trace LEVEL and that it returned VALUE. | |
202 (format "%s%s%d <- %s: %s\n" | |
203 (mapconcat 'char-to-string (make-string (1- level) ?|) " ") | |
204 (if (> level 1) " " "") | |
205 level | |
206 function | |
207 ;; do this so we'll see strings: | |
95577
e283d325f1bc
(trace-entry-message, trace-exit-message): Use print-circle.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
94655
diff
changeset
|
208 (let ((print-circle t)) (prin1-to-string value)))) |
2854 | 209 |
210 (defun trace-make-advice (function buffer background) | |
211 ;; Builds the piece of advice to be added to FUNCTION's advice info | |
212 ;; so that it will generate the proper trace output in BUFFER | |
213 ;; (quietly if BACKGROUND is t). | |
214 (ad-make-advice | |
215 trace-advice-name nil t | |
60276
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
216 `(advice |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
217 lambda () |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
218 (let ((trace-level (1+ trace-level)) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
219 (trace-buffer (get-buffer-create ,buffer))) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
220 (unless inhibit-trace |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
221 (with-current-buffer trace-buffer |
95777
edc51d72cb17
* window.c (Vwindow_point_insertion_type): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
95577
diff
changeset
|
222 (set (make-local-variable 'window-point-insertion-type) t) |
edc51d72cb17
* window.c (Vwindow_point_insertion_type): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
95577
diff
changeset
|
223 ,(unless background '(display-buffer trace-buffer)) |
60276
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
224 (goto-char (point-max)) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
225 ;; Insert a separator from previous trace output: |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
226 (if (= trace-level 1) (insert trace-separator)) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
227 (insert |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
228 (trace-entry-message |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
229 ',function trace-level ad-arg-bindings)))) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
230 ad-do-it |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
231 (unless inhibit-trace |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
232 (with-current-buffer trace-buffer |
94179
d55e28c98546
(trace-make-advice): Don't change selected-window.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
79704
diff
changeset
|
233 ,(unless background '(display-buffer trace-buffer)) |
60276
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
234 (goto-char (point-max)) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
235 (insert |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
236 (trace-exit-message |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
237 ',function trace-level ad-return-value)))))))) |
2854 | 238 |
239 (defun trace-function-internal (function buffer background) | |
240 ;; Adds trace advice for FUNCTION and activates it. | |
241 (ad-add-advice | |
242 function | |
243 (trace-make-advice function (or buffer trace-buffer) background) | |
244 'around 'last) | |
245 (ad-activate function nil)) | |
246 | |
247 (defun trace-is-traced (function) | |
248 (ad-find-advice function 'around trace-advice-name)) | |
249 | |
250 ;;;###autoload | |
251 (defun trace-function (function &optional buffer) | |
252 "Traces FUNCTION with trace output going to BUFFER. | |
253 For every call of FUNCTION Lisp-style trace messages that display argument | |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
254 and return values will be inserted into BUFFER. This function generates the |
2854 | 255 trace advice for FUNCTION and activates it together with any other advice |
107517
ed16fdd2685a
Fix typos in docstrings.
Juanma Barranquero <lekktu@gmail.com>
parents:
106815
diff
changeset
|
256 there might be!! The trace BUFFER will popup whenever FUNCTION is called. |
2854 | 257 Do not use this to trace functions that switch buffers or do any other |
258 display oriented stuff, use `trace-function-background' instead." | |
259 (interactive | |
260 (list | |
261 (intern (completing-read "Trace function: " obarray 'fboundp t)) | |
262 (read-buffer "Output to buffer: " trace-buffer))) | |
263 (trace-function-internal function buffer nil)) | |
264 | |
265 ;;;###autoload | |
266 (defun trace-function-background (function &optional buffer) | |
267 "Traces FUNCTION with trace output going quietly to BUFFER. | |
72586
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
268 When this tracing is enabled, every call to FUNCTION writes |
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
269 a Lisp-style trace message (showing the arguments and return value) |
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
270 into BUFFER. This function generates advice to trace FUNCTION |
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
271 and activates it together with any other advice there might be. |
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
272 The trace output goes to BUFFER quietly, without changing |
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
273 the window or buffer configuration. |
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
274 |
6ad55ad9813c
(trace-function-background): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents:
68648
diff
changeset
|
275 BUFFER defaults to `trace-buffer'." |
2854 | 276 (interactive |
277 (list | |
278 (intern | |
279 (completing-read "Trace function in background: " obarray 'fboundp t)) | |
280 (read-buffer "Output to buffer: " trace-buffer))) | |
281 (trace-function-internal function buffer t)) | |
282 | |
283 (defun untrace-function (function) | |
284 "Untraces FUNCTION and possibly activates all remaining advice. | |
285 Activation is performed with `ad-update', hence remaining advice will get | |
47609
9c74f4f1d1c0
Add/remove spaces.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
28574
diff
changeset
|
286 activated only if the advice of FUNCTION is currently active. If FUNCTION |
2854 | 287 was not traced this is a noop." |
288 (interactive | |
289 (list (ad-read-advised-function "Untrace function: " 'trace-is-traced))) | |
60276
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
290 (when (trace-is-traced function) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
291 (ad-remove-advice function 'around trace-advice-name) |
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
292 (ad-update function))) |
2854 | 293 |
294 (defun untrace-all () | |
295 "Untraces all currently traced functions." | |
296 (interactive) | |
297 (ad-do-advised-functions (function) | |
298 (untrace-function function))) | |
299 | |
300 (provide 'trace) | |
301 | |
60276
eeb966123ab7
(inhibit-trace): New var.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
302 ;; arch-tag: cfd170a7-4932-4331-8c8b-b7151942e5a1 |
2854 | 303 ;;; trace.el ends here |