aboutsummaryrefslogtreecommitdiffstats
path: root/lisp
diff options
context:
space:
mode:
authorNoam Postavsky2020-04-14 22:10:58 -0400
committerNoam Postavsky2020-04-25 09:55:37 -0400
commit45a64c97c74c34d3d2e912a670b30aa10dbf439c (patch)
treefc23ea0b474cc8a432ae3033128309d8234450c1 /lisp
parent821760fdc439214f57212708e23d5c87088d34ee (diff)
downloademacs-45a64c97c74c34d3d2e912a670b30aa10dbf439c.tar.gz
emacs-45a64c97c74c34d3d2e912a670b30aa10dbf439c.zip
Clarify semantics of trace-function CONTEXT argument
* lisp/emacs-lisp/trace.el (trace-function-foreground): Explain that CONTEXT should be a function, when called from Lisp.
Diffstat (limited to 'lisp')
-rw-r--r--lisp/emacs-lisp/trace.el4
1 files changed, 3 insertions, 1 deletions
diff --git a/lisp/emacs-lisp/trace.el b/lisp/emacs-lisp/trace.el
index 5c35036a50d..4ebb7ff711d 100644
--- a/lisp/emacs-lisp/trace.el
+++ b/lisp/emacs-lisp/trace.el
@@ -292,7 +292,9 @@ If `current-prefix-arg' is non-nil, also read a buffer and a \"context\"
292(defun trace-function-foreground (function &optional buffer context) 292(defun trace-function-foreground (function &optional buffer context)
293 "Trace calls to function FUNCTION. 293 "Trace calls to function FUNCTION.
294With a prefix argument, also prompt for the trace buffer (default 294With a prefix argument, also prompt for the trace buffer (default
295`trace-buffer'), and a Lisp expression CONTEXT. 295`trace-buffer'), and a Lisp expression CONTEXT. When called from
296Lisp, CONTEXT should be a function of no arguments which returns
297a value to insert into BUFFER during the trace.
296 298
297Tracing a function causes every call to that function to insert 299Tracing a function causes every call to that function to insert
298into BUFFER Lisp-style trace messages that display the function's 300into BUFFER Lisp-style trace messages that display the function's