aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/debugging.texi
diff options
context:
space:
mode:
authorAlan Mackenzie2020-12-22 12:06:21 +0000
committerAlan Mackenzie2020-12-22 12:06:21 +0000
commit9920929e7b538f8bf8fb1dd7a9ae7cd1fe5d2b31 (patch)
tree49900fc5aff77800d994796df7c3f4b4e6401fdc /doc/lispref/debugging.texi
parent188b09d6d9b12a2ec7f8ed4ad4c0bd55acbb37b1 (diff)
downloademacs-9920929e7b538f8bf8fb1dd7a9ae7cd1fe5d2b31.tar.gz
emacs-9920929e7b538f8bf8fb1dd7a9ae7cd1fe5d2b31.zip
Re-order the items in `profiler-report' output.
Putting the usage figures first on the line will eliminate the truncation of function names. lisp/profiler.el (profiler-version): Change to "28.1". (profiler-format): Enhance, so that a width of zero means print the string without padding or truncation. (profiler-report-cpu-line-format, profiler-report-memory-line-format): Amend for the new layout. The number of places for the cpu samples has been reduced from 19 to 12 (enough for ~30 years at 1,000 samples per second). (profiler-report-line-format, profiler-report-describe-entry): Amend for the new order of arguments to profiler-format. etc/NEWS (Specialized Modes): Add an entry documenting this change. doc/lispref/debugging.texi (Profiling): Describe the new ordering of the items in place of the old ordering.
Diffstat (limited to 'doc/lispref/debugging.texi')
-rw-r--r--doc/lispref/debugging.texi13
1 files changed, 7 insertions, 6 deletions
diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi
index 3fea604184c..661961f9379 100644
--- a/doc/lispref/debugging.texi
+++ b/doc/lispref/debugging.texi
@@ -1009,13 +1009,14 @@ profiling, so we don't recommend leaving it active except when you are
1009actually running the code you want to examine). 1009actually running the code you want to examine).
1010 1010
1011The profiler report buffer shows, on each line, a function that was 1011The profiler report buffer shows, on each line, a function that was
1012called, followed by how much resources (cpu or memory) it used in 1012called, preceded by how much resources (cpu or memory) it used in
1013absolute and percentage terms since profiling started. If a given 1013absolute and percentage terms since profiling started. If a given
1014line has a @samp{+} symbol at the left-hand side, you can expand that 1014line has a @samp{+} symbol to the left of the function name, you can
1015line by typing @kbd{@key{RET}}, in order to see the function(s) called 1015expand that line by typing @kbd{@key{RET}}, in order to see the
1016by the higher-level function. Use a prefix argument (@kbd{C-u 1016function(s) called by the higher-level function. Use a prefix
1017@key{RET}}) to see the whole call tree below a function. Pressing 1017argument (@kbd{C-u @key{RET}}) to see the whole call tree below a
1018@kbd{@key{RET}} again will collapse back to the original state. 1018function. Pressing @kbd{@key{RET}} again will collapse back to the
1019original state.
1019 1020
1020Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function 1021Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function
1021at point. Press @kbd{d} to view a function's documentation. You can 1022at point. Press @kbd{d} to view a function's documentation. You can