18.2 Edebug

Edebug is a source-level debugger for Emacs Lisp programs with which you can:

• Step through evaluation, stopping before and after each expression.

• Set conditional or unconditional breakpoints.

• Stop when a specified condition is true (the global break event).

• Trace slow or fast, stopping briefly at each stop point, or at each breakpoint.

• Display expression results and evaluate expressions as if outside of Edebug.

• Automatically re-evaluate a list of expressions and display their results each time Edebug updates the display.

• Output trace info on function enter and exit.

• Stop when an error occurs.

• Display a backtrace, omitting Edebug's own frames.

• Specify argument evaluation for macros and defining forms.

• Obtain rudimentary coverage testing and frequency counts.

The first three sections below should tell you enough about Edebug to enable you to use it.

18.2.1 Using Edebug		Introduction to use of Edebug.
18.2.2 Instrumenting for Edebug		You must instrument your code in order to debug it with Edebug.
18.2.3 Edebug Execution Modes		Execution modes, stopping more or less often.
18.2.4 Jumping		Commands to jump to a specified place.
18.2.5 Miscellaneous Edebug Commands		Miscellaneous commands.
18.2.6 Breakpoints		Setting breakpoints to make the program stop.
18.2.7 Trapping Errors		Trapping errors with Edebug.
18.2.8 Edebug Views		Views inside and outside of Edebug.
18.2.9 Evaluation		Evaluating expressions within Edebug.
18.2.10 Evaluation List Buffer		Expressions whose values are displayed each time you enter Edebug.
18.2.11 Printing in Edebug		Customization of printing.
18.2.12 Trace Buffer		How to produce trace output in a buffer.
18.2.13 Coverage Testing		How to test evaluation coverage.
18.2.14 The Outside Context		Data that Edebug saves and restores.
18.2.15 Instrumenting Macro Calls		Specifying how to handle macro calls.
18.2.16 Edebug Options		Option variables for customizing Edebug.