# HG changeset patch # User Richard M. Stallman # Date 1066073010 0 # Node ID 590f500fb14b5779d2e224a087d09a4ba683ca99 # Parent f4f7a204bc03380b3cf760c78eeb2fa5268e35d2 (Edebug Execution Modes): Clarify t. Document edebug-sit-for-seconds. (Coverage Testing): Document C-x X = and =. (Instrumenting Macro Calls): Fix typo. (Specification List): Don't index the specification keywords. diff -r f4f7a204bc03 -r 590f500fb14b lispref/edebug.texi --- a/lispref/edebug.texi Mon Oct 13 18:50:35 2003 +0000 +++ b/lispref/edebug.texi Mon Oct 13 19:23:30 2003 +0000 @@ -257,7 +257,8 @@ @ref{Edebug Misc}. @item t -Trace: pause one second at each Edebug stop point (@code{edebug-trace-mode}). +Trace: pause (normally one second) at each Edebug stop point +(@code{edebug-trace-mode}). @item T Rapid trace: update the display at each stop point, but don't actually @@ -307,6 +308,10 @@ several times if, for example, an instrumented function is called several times from one command. +@defopt edebug-sit-for-seconds +This option specifies how many seconds to wait between execution steps +in trace mode. The default is 1 second. +@end defvar @node Jumping @subsection Jumping @@ -871,8 +876,12 @@ execution mode is Go-nonstop, and regardless of whether coverage testing is enabled. - Use @kbd{M-x edebug-display-freq-count} to display both the -coverage information and the frequency counts for a definition. +@kindex C-x X = +@findex edebug-temp-display-freq-count + Use @kbd{C-x X =} (@code{edebug-display-freq-count}) to display both +the coverage information and the frequency counts for a definition. +Just @kbd{=} (@code{edebug-temp-display-freq-count}) displays the same +information temporarily, only until you type another key. @deffn Command edebug-display-freq-count This command displays the frequency count data for each line of the @@ -1077,7 +1086,7 @@ ...) @end example - The Edebug specifation says which parts of a call to the macro are + The Edebug specification says which parts of a call to the macro are forms to be evaluated. For simple macros, the @var{specification} often looks very similar to the formal argument list of the macro definition, but specifications are much more general than macro @@ -1184,7 +1193,7 @@ A lambda expression with no quoting. @item &optional -@kindex &optional @r{(Edebug)} +@c @kindex &optional @r{(Edebug)} All following elements in the specification list are optional; as soon as one does not match, Edebug stops matching at this level. @@ -1194,7 +1203,7 @@ [@var{specs}@dots{}]}. See the @code{defun} example below. @item &rest -@kindex &rest @r{(Edebug)} +@c @kindex &rest @r{(Edebug)} All following elements in the specification list are repeated zero or more times. In the last repetition, however, it is not a problem if the expression runs out before matching all of the elements of the @@ -1205,7 +1214,7 @@ @code{&rest [@var{specs}@dots{}]}. @item &or -@kindex &or @r{(Edebug)} +@c @kindex &or @r{(Edebug)} Each of the following elements in the specification list is an alternative. One of the alternatives must match, or the @code{&or} specification fails. @@ -1215,14 +1224,14 @@ @code{[@dots{}]}. @item ¬ -@kindex ¬ @r{(Edebug)} +@c @kindex ¬ @r{(Edebug)} Each of the following elements is matched as alternatives as if by using @code{&or}, but if any of them match, the specification fails. If none of them match, nothing is matched, but the @code{¬} specification succeeds. @item &define -@kindex &define @r{(Edebug)} +@c @kindex &define @r{(Edebug)} Indicates that the specification is for a defining form. The defining form itself is not instrumented (that is, Edebug does not stop before and after the defining form), but forms inside it typically will be