diff options
| author | Alan Mackenzie | 2020-12-22 12:06:21 +0000 |
|---|---|---|
| committer | Alan Mackenzie | 2020-12-22 12:06:21 +0000 |
| commit | 9920929e7b538f8bf8fb1dd7a9ae7cd1fe5d2b31 (patch) | |
| tree | 49900fc5aff77800d994796df7c3f4b4e6401fdc /doc/lispref/debugging.texi | |
| parent | 188b09d6d9b12a2ec7f8ed4ad4c0bd55acbb37b1 (diff) | |
| download | emacs-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.texi | 13 |
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 | |||
| 1009 | actually running the code you want to examine). | 1009 | actually running the code you want to examine). |
| 1010 | 1010 | ||
| 1011 | The profiler report buffer shows, on each line, a function that was | 1011 | The profiler report buffer shows, on each line, a function that was |
| 1012 | called, followed by how much resources (cpu or memory) it used in | 1012 | called, preceded by how much resources (cpu or memory) it used in |
| 1013 | absolute and percentage terms since profiling started. If a given | 1013 | absolute and percentage terms since profiling started. If a given |
| 1014 | line has a @samp{+} symbol at the left-hand side, you can expand that | 1014 | line has a @samp{+} symbol to the left of the function name, you can |
| 1015 | line by typing @kbd{@key{RET}}, in order to see the function(s) called | 1015 | expand that line by typing @kbd{@key{RET}}, in order to see the |
| 1016 | by the higher-level function. Use a prefix argument (@kbd{C-u | 1016 | function(s) called by the higher-level function. Use a prefix |
| 1017 | @key{RET}}) to see the whole call tree below a function. Pressing | 1017 | argument (@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. | 1018 | function. Pressing @kbd{@key{RET}} again will collapse back to the |
| 1019 | original state. | ||
| 1019 | 1020 | ||
| 1020 | Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function | 1021 | Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function |
| 1021 | at point. Press @kbd{d} to view a function's documentation. You can | 1022 | at point. Press @kbd{d} to view a function's documentation. You can |