/[emacs]/emacs/lispref/edebug.texi
ViewVC logotype

Diff of /emacs/lispref/edebug.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.14.2.1 by miles, Fri Apr 4 06:20:41 2003 UTC revision 1.14.2.2 by miles, Tue Oct 14 23:10:11 2003 UTC
# Line 257  Next: stop at the next stop point encoun Line 257  Next: stop at the next stop point encoun
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
# Line 307  specifies step mode.  Note that you may Line 308  specifies step mode.  Note that you may
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
# Line 871  performed for all execution of an instru Line 876  performed for all execution of an instru
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
# Line 1077  For example, (for i from 1 to 10 do (pri Line 1086  For example, (for i from 1 to 10 do (pri
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
# Line 1185  either way. Line 1193  either way.
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    
# Line 1195  elements must all match or none, use @co Line 1203  elements must all match or none, use @co
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
# Line 1206  To specify several elements that must al Line 1214  To specify several elements that must al
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.
# Line 1216  group two or more list elements as a sin Line 1224  group two or more list elements as a sin
1224  @code{[@dots{}]}.  @code{[@dots{}]}.
1225    
1226  @item &not  @item &not
1227  @kindex &not @r{(Edebug)}  @c @kindex &not @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{&not} specification  of them match, nothing is matched, but the @code{&not} 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
# Line 1550  until the @emph{next} time Edebug is inv Line 1558  until the @emph{next} time Edebug is inv
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

Legend:
Removed from v.1.14.2.1  
changed lines
  Added in v.1.14.2.2

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26