From: Noam Postavsky Date: Wed, 15 Apr 2020 02:10:58 +0000 (-0400) Subject: Clarify semantics of trace-function CONTEXT argument X-Git-Tag: emacs-27.1-rc1~183 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=45a64c97c74c34d3d2e912a670b30aa10dbf439c;p=emacs.git 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. --- 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\" (defun trace-function-foreground (function &optional buffer context) "Trace calls to function FUNCTION. With a prefix argument, also prompt for the trace buffer (default -`trace-buffer'), and a Lisp expression CONTEXT. +`trace-buffer'), and a Lisp expression CONTEXT. When called from +Lisp, CONTEXT should be a function of no arguments which returns +a value to insert into BUFFER during the trace. Tracing a function causes every call to that function to insert into BUFFER Lisp-style trace messages that display the function's