257 |
@ref{Edebug Misc}. |
@ref{Edebug Misc}. |
258 |
|
|
259 |
@item t |
@item t |
260 |
Trace: pause one second at each Edebug stop point (@code{edebug-trace-mode}). |
Trace: pause (normally one second) at each Edebug stop point |
261 |
|
(@code{edebug-trace-mode}). |
262 |
|
|
263 |
@item T |
@item T |
264 |
Rapid trace: update the display at each stop point, but don't actually |
Rapid trace: update the display at each stop point, but don't actually |
308 |
several times if, for example, an instrumented function is called |
several times if, for example, an instrumented function is called |
309 |
several times from one command. |
several times from one command. |
310 |
|
|
311 |
|
@defopt edebug-sit-for-seconds |
312 |
|
This option specifies how many seconds to wait between execution steps |
313 |
|
in trace mode. The default is 1 second. |
314 |
|
@end defopt |
315 |
|
|
316 |
@node Jumping |
@node Jumping |
317 |
@subsection Jumping |
@subsection Jumping |
876 |
execution mode is Go-nonstop, and regardless of whether coverage testing |
execution mode is Go-nonstop, and regardless of whether coverage testing |
877 |
is enabled. |
is enabled. |
878 |
|
|
879 |
Use @kbd{M-x edebug-display-freq-count} to display both the |
@kindex C-x X = |
880 |
coverage information and the frequency counts for a definition. |
@findex edebug-temp-display-freq-count |
881 |
|
Use @kbd{C-x X =} (@code{edebug-display-freq-count}) to display both |
882 |
|
the coverage information and the frequency counts for a definition. |
883 |
|
Just @kbd{=} (@code{edebug-temp-display-freq-count}) displays the same |
884 |
|
information temporarily, only until you type another key. |
885 |
|
|
886 |
@deffn Command edebug-display-freq-count |
@deffn Command edebug-display-freq-count |
887 |
This command displays the frequency count data for each line of the |
This command displays the frequency count data for each line of the |
1086 |
...) |
...) |
1087 |
@end example |
@end example |
1088 |
|
|
1089 |
@defspec declare (edebug @var{specification}) |
The Edebug specification says which parts of a call to the macro are |
1090 |
Specify which expressions of a call to the macro in which the |
forms to be evaluated. For simple macros, the @var{specification} |
1091 |
declaration appears are forms to be evaluated. For simple macros, the |
often looks very similar to the formal argument list of the macro |
1092 |
@var{specification} often looks very similar to the formal argument list |
definition, but specifications are much more general than macro |
1093 |
of the macro definition, but specifications are much more general than |
arguments. @xref{Defining Macros}, for more explanation of |
1094 |
macro arguments. |
the @code{declare} special form. |
|
@end defspec |
|
1095 |
|
|
1096 |
You can also define an edebug specification for a macro separately |
You can also define an edebug specification for a macro separately |
1097 |
from the macro definition with @code{def-edebug-spec}. Adding |
from the macro definition with @code{def-edebug-spec}. Adding |
1098 |
@code{edebug} declarations is preferred, and more convenient, for |
@code{edebug} declarations is preferred, and more convenient, for |
1099 |
macro definitions in Lisp, but @code{def-edebug-spec} makes it |
macro definitions in Lisp, but @code{def-edebug-spec} makes it |
1193 |
A lambda expression with no quoting. |
A lambda expression with no quoting. |
1194 |
|
|
1195 |
@item &optional |
@item &optional |
1196 |
@kindex &optional @r{(Edebug)} |
@c @kindex &optional @r{(Edebug)} |
1197 |
All following elements in the specification list are optional; as soon |
All following elements in the specification list are optional; as soon |
1198 |
as one does not match, Edebug stops matching at this level. |
as one does not match, Edebug stops matching at this level. |
1199 |
|
|
1203 |
[@var{specs}@dots{}]}. See the @code{defun} example below. |
[@var{specs}@dots{}]}. See the @code{defun} example below. |
1204 |
|
|
1205 |
@item &rest |
@item &rest |
1206 |
@kindex &rest @r{(Edebug)} |
@c @kindex &rest @r{(Edebug)} |
1207 |
All following elements in the specification list are repeated zero or |
All following elements in the specification list are repeated zero or |
1208 |
more times. In the last repetition, however, it is not a problem if the |
more times. In the last repetition, however, it is not a problem if the |
1209 |
expression runs out before matching all of the elements of the |
expression runs out before matching all of the elements of the |
1214 |
@code{&rest [@var{specs}@dots{}]}. |
@code{&rest [@var{specs}@dots{}]}. |
1215 |
|
|
1216 |
@item &or |
@item &or |
1217 |
@kindex &or @r{(Edebug)} |
@c @kindex &or @r{(Edebug)} |
1218 |
Each of the following elements in the specification list is an |
Each of the following elements in the specification list is an |
1219 |
alternative. One of the alternatives must match, or the @code{&or} |
alternative. One of the alternatives must match, or the @code{&or} |
1220 |
specification fails. |
specification fails. |
1224 |
@code{[@dots{}]}. |
@code{[@dots{}]}. |
1225 |
|
|
1226 |
@item ¬ |
@item ¬ |
1227 |
@kindex ¬ @r{(Edebug)} |
@c @kindex ¬ @r{(Edebug)} |
1228 |
Each of the following elements is matched as alternatives as if by using |
Each of the following elements is matched as alternatives as if by using |
1229 |
@code{&or}, but if any of them match, the specification fails. If none |
@code{&or}, but if any of them match, the specification fails. If none |
1230 |
of them match, nothing is matched, but the @code{¬} specification |
of them match, nothing is matched, but the @code{¬} specification |
1231 |
succeeds. |
succeeds. |
1232 |
|
|
1233 |
@item &define |
@item &define |
1234 |
@kindex &define @r{(Edebug)} |
@c @kindex &define @r{(Edebug)} |
1235 |
Indicates that the specification is for a defining form. The defining |
Indicates that the specification is for a defining form. The defining |
1236 |
form itself is not instrumented (that is, Edebug does not stop before and |
form itself is not instrumented (that is, Edebug does not stop before and |
1237 |
after the defining form), but forms inside it typically will be |
after the defining form), but forms inside it typically will be |
1558 |
@c A new command is not precisely true, but that is close enough -- dan |
@c A new command is not precisely true, but that is close enough -- dan |
1559 |
|
|
1560 |
@defopt edebug-global-break-condition |
@defopt edebug-global-break-condition |
1561 |
If non-@code{nil}, an expression to test for at every stop point. |
If non-@code{nil}, an expression to test for at every stop point. If |
1562 |
If the result is non-nil, then break. Errors are ignored. |
the result is non-@code{nil}, then break. Errors are ignored. |
1563 |
@xref{Global Break Condition}. |
@xref{Global Break Condition}. |
1564 |
@end defopt |
@end defopt |
1565 |
|
|
1566 |
|
@ignore |
1567 |
|
arch-tag: 74842db8-019f-4818-b5a4-b2de878e57fd |
1568 |
|
@end ignore |