diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/lispref/edebug.texi | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/doc/lispref/edebug.texi b/doc/lispref/edebug.texi index cebf0a3af3d..94d61480f10 100644 --- a/doc/lispref/edebug.texi +++ b/doc/lispref/edebug.texi | |||
| @@ -1690,3 +1690,38 @@ Whether or not to pause for @code{edebug-sit-for-seconds} on reaching | |||
| 1690 | a breakpoint. Set to @code{nil} to prevent the pause, non-@code{nil} | 1690 | a breakpoint. Set to @code{nil} to prevent the pause, non-@code{nil} |
| 1691 | to allow it. | 1691 | to allow it. |
| 1692 | @end defopt | 1692 | @end defopt |
| 1693 | |||
| 1694 | @defopt edebug-behavior-alist | ||
| 1695 | By default, this alist contains one entry with the key @code{edebug} | ||
| 1696 | and a list of three functions, which are the default implementations | ||
| 1697 | of the functions inserted in instrumented code: @code{edebug-enter}, | ||
| 1698 | @code{edebug-before} and @code{edebug-after}. To change Edebug's | ||
| 1699 | behavior globally, modify the default entry. | ||
| 1700 | |||
| 1701 | Edebug's behavior may also be changed on a per-definition basis by | ||
| 1702 | adding an entry to this alist, with a key of your choice and three | ||
| 1703 | functions. Then set the @code{edebug-behavior} symbol property of an | ||
| 1704 | instrumented definition to the key of the new entry, and Edebug will | ||
| 1705 | call the new functions in place of its own for that definition. | ||
| 1706 | @end defopt | ||
| 1707 | |||
| 1708 | @defopt edebug-new-definition-functions | ||
| 1709 | An abnormal hook run by Edebug after it wraps the body of a definition | ||
| 1710 | or closure. After Edebug has initialized its own data, each function | ||
| 1711 | is called with one argument, the symbol associated with the | ||
| 1712 | definition, which may be the actual symbol defined or one generated by | ||
| 1713 | Edebug. This hook may be used to set the @code{edebug-behavior} | ||
| 1714 | symbol property of each definition instrumented by Edebug. | ||
| 1715 | |||
| 1716 | By default @code{edebug-new-definition-functions} contains | ||
| 1717 | @code{edebug-announce-definition} which prints a message each time a | ||
| 1718 | definition is instrumented. If you are instrumenting a lot of code | ||
| 1719 | and find the messages excessive, remove | ||
| 1720 | @code{edebug-announce-definition}. | ||
| 1721 | @end defopt | ||
| 1722 | |||
| 1723 | @defopt edebug-after-instrumentation-functions | ||
| 1724 | An abnormal hook run by Edebug after it instruments a form. | ||
| 1725 | Each function is called with one argument, a form which has | ||
| 1726 | just been instrumented by Edebug. | ||
| 1727 | @end defopt | ||