From: Noam Postavsky <npostavs@gmail.com>
Date: Sun, 17 Jul 2016 04:21:42 +0000 (-0400)
Subject: profiler: document prefix arg for tree expansion
X-Git-Tag: emacs-25.1-rc2~33
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=272391f;p=emacs.git

profiler: document prefix arg for tree expansion

* doc/lispref/debugging.texi (Profiling):
* lisp/profiler.el (profiler-report-toggle-entry): Document use of
prefix argument to expand whole call trees.
---

diff --git a/doc/lispref/debugging.texi b/doc/lispref/debugging.texi
index 98c47052cb0..2f83b4040fa 100644
--- a/doc/lispref/debugging.texi
+++ b/doc/lispref/debugging.texi
@@ -840,8 +840,9 @@ called, followed by how much resource (processor or memory) it used in
 absolute and percentage times since profiling started.  If a given
 line has a @samp{+} symbol at the left-hand side, you can expand that
 line by typing @key{RET}, in order to see the function(s) called by
-the higher-level function.  Pressing @key{RET} again will collapse
-back to the original state.
+the higher-level function.  Use a prefix argument (@key{C-u RET}) to
+see the whole call tree below a function.  Pressing @key{RET} again
+will collapse back to the original state.
 
 Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function.
 Press @kbd{d} to view a function's documentation.
diff --git a/lisp/profiler.el b/lisp/profiler.el
index 401cae537e6..3bee3c561a7 100644
--- a/lisp/profiler.el
+++ b/lisp/profiler.el
@@ -692,7 +692,8 @@ With a prefix argument, expand the whole subtree."
 
 (defun profiler-report-toggle-entry (&optional arg)
   "Expand entry at point if the tree is collapsed,
-otherwise collapse."
+otherwise collapse.  With prefix argument, expand all subentries
+below entry at point."
   (interactive "P")
   (or (profiler-report-expand-entry arg)
       (profiler-report-collapse-entry)))