Commit b6729a18 authored by Glenn Morris's avatar Glenn Morris

Add a bit more about profiling to the lispref

* doc/lispref/debugging.texi (Profiling):
Add some basic information about the profile report buffer.
(Debugging): Mention profiling in the introduction.
parent 38a2f917
2012-11-21 Glenn Morris <rgm@gnu.org> 2012-11-21 Glenn Morris <rgm@gnu.org>
* debugging.texi (Profiling) [!tex]: Mention --enable-profiling. * debugging.texi (Profiling): Mention --enable-profiling (if !tex).
Add some basic information about the profile report buffer.
(Debugging): Mention profiling in the introduction.
2012-11-20 Glenn Morris <rgm@gnu.org> 2012-11-20 Glenn Morris <rgm@gnu.org>
......
...@@ -32,6 +32,9 @@ program. ...@@ -32,6 +32,9 @@ program.
@item @item
You can use the ERT package to write regression tests for the program. You can use the ERT package to write regression tests for the program.
@xref{Top,the ERT manual,, ERT, ERT: Emacs Lisp Regression Testing}. @xref{Top,the ERT manual,, ERT, ERT: Emacs Lisp Regression Testing}.
@item
You can profile the program to get hints about how to make it more efficient.
@end itemize @end itemize
Other useful tools for debugging input and output problems are the Other useful tools for debugging input and output problems are the
...@@ -834,10 +837,20 @@ generate another report later on without erasing previous results. ...@@ -834,10 +837,20 @@ generate another report later on without erasing previous results.
When you have finished profiling, type @kbd{M-x profiler-stop} (there When you have finished profiling, type @kbd{M-x profiler-stop} (there
is a small overhead associated with profiling). is a small overhead associated with profiling).
@c FIXME The profiler report buffer shows, on each line, a function that was
@c Basic apperance of the report buffer: 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.
Press @kbd{j} or @kbd{mouse-2} to jump to the definition of a function.
Press @kbd{d} to view a function's documentation.
You can save a profile to a file using @kbd{C-x C-w}.
You can compare two profiles using @kbd{=}.
@c The following commands are available in the report buffer: @c FIXME reversed calltree?
@cindex @file{elp.el} @cindex @file{elp.el}
@cindex timing programs @cindex timing programs
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment