▼ |  | Dr Racket Plugins

1 | Implementing Dr Racket Plugins
2 | Adding Languages to Dr Racket
3 | Creating New Kinds of Dr Racket Frames
4 | Extending the Existing Dr Racket Classes
5 | Expanding the User’s Program Text and Breaking
6 | Editor Modes
7 | Language-Specific Capabilities
8 | Check Syntax
9 | Teaching Languages
10 | Signatures
11 | drracket: get/ extend
12 | drracket: unit
13 | drracket: language
14 | drracket: language-configuration
15 | drracket: debug
16 | drracket: rep
17 | drracket: frame
18 | drracket: help-desk
19 | drracket: eval
20 | drracket: modes
21 | drracket: module-language-tools
22 | drracket: module-language
23 | Backwards Compatibility
| Index

top ← prev up next →

### 5`` Expanding the User’s Program Text and Breaking

Macro-expanding a program may involve arbitrary computation and requires the setup of the correct language. To aid this, DrRacket’s tool interface provides drracket:eval:expand-program to help. Use this method to extract the fully expanded program text in a particular language.

Because expanding the user’s program may require DrRacket to evaluate arbitrary code that the user wrote, tools that expand the user’s program should also allow the user to break the expansion. To help with this, the tools interfaces provides these methods: enable-evaluation and disable-evaluation. Since your tool will be expanding the program text, you should be both overriding enable-evaluation and disable-evaluation to disable your tool and calling them to ensure that only one expansion is happening at a time.

Finally, DrRacket provides the set-breakables method. This method controls what behavior the Break button has.

top ← prev up next →