3.1 Menus
3.1.1 File
Open... : Opens a find-file dialog for choosing a file to load into a definitions window.
Open Recent : Lists recently opened files. Choosing one of them opens that file for editing.
Install PLT File... : Opens a dialog asking for the location of the ".plt" file (either on the local disk or on the web) and installs the contents of the file.
Revert : Re-loads the file that is currently in the definitions window. All changes since the file was last saved will be lost.
Save Definitions : Saves the program in the definitions window. If the program has never been saved before, a save-file dialog appears.
Save Definitions As... : Opens a save-file dialog for choosing a destination file to save the program in the definitions window. Subsequent saves write to the newly-selected file.
Save Other : Contains these sub-items
Save Definitions As Text... : Like Save Definitions As..., but the file is saved in plain-text format (see Program Files). Subsequent saves also write in plain-text format.
Save Interactions : Saves the contents of the interactions window to a file. If the interaction constants have never been saved before, a save-file dialog appears.
Save Interactions As... : Opens a save-file dialog for choosing a destination file to save the contents of the interactions window. Subsequent saves write to the newly-selected file.
Save Interactions As Text... : Like Save Interactions As..., but the file is saved in plain-text format (see Program Files). Subsequent saves are write in plain-text format.
Log Definitions and Interactions... : Starts a running of log of the text in the interactions and definitions windows, organized by executions. In a directory of your choosing, DrScheme saves files with the names "01-definitions", "01-interactions", "02-definitions", "02-interactions", etc. as you interact with various programs.
Print Definitions... : Opens a dialog for printing the current program in the definitions window.
Print Interactions... : Opens a dialog for printing the contents of the interactions window.
Search in Files... : Opens a dialog where you can specify the parameters of a multi-file search. The results of the search are displayed in a separate window.
Close : Closes this DrScheme window. If this window is the only open DrScheme window, then DrScheme quits, except under Mac OS X.
{Quit or Exit} Exits DrScheme. (Under Mac OS X, this menu item is in the Apple menu.)
3.1.2 Edit
All Edit menu items operate on either the definitions or interactions window, depending on the location of the selection or blinking caret. Each window maintains its own Undo and Redo history.
Undo : Reverses an editing action. Each window maintains a history of actions, so multiple Undo operations can reverse multiple editing actions.
Redo : Reverses an Undo action. Each window (and boxed-subwindow) maintains its own history of Undo actions, so multiple Redo operations can reverse multiple Undo actions.
Cut : Copies the selected text to the clipboard and deletes it from the window.
Paste : Pastes the current clipboard contents into the window.
Wrap Text : Toggles between wrapped text and unwrapped text in the window.
Find... : Opens an interactive search window at the bottom of the frame and moves the insertion point to the search string editor (or out of it, if the insertion point is already there.
See also Searching.
Find Again : Finds the next occurrence of the text in the search window.
Find Again Backwards : Finds the next occurrence of the text in the search window, but searching backwards.
Replace & Find Again : Replaces the selection with the replace string (if it matches the find string) and finds the next occurrence of the text that was last searched for, looking forwards.
Replace & Find Again Backwards : Replaces the selection with the replace string (if it matches the find string) and finds the next occurrence of the text that was last searched for, looking backwards.
Replace All : Replaces all occurrences of the search string with the replace string.
Find Case Sensitive : Toggles between case-sensitive and case-insensitive search.
Show Active Keybindings : Shows all of the keybindings available in the current window.
Add User-defined Keybindings... : Choosing this menu item opens a file dialog where you can select a file containing Scheme-definitions of keybindings. See Defining Custom Shortcuts for more information.
Complete Word : Completes the word at the insertion point, using the manuals as a source of completions.
Preferences... : Opens the preferences dialog. See Preferences. (Under Mac OS X, this menu item is in the Apple menu.)
3.1.3 View
One each of the following show/hide pairs of menu items appears at any time.
Show Program Contour : Shows a “20,000 foot” overview window along the edge of the DrScheme window. Each pixel in this window corresponds to a letter in the program text.
Show Module Browser : Shows the module DAG rooted at the currently opened file in DrScheme.
Show Toolbar : Makes the toolbar (along the top of DrScheme’s window) and the status line (along the bottom) visible.
Hide Toolbar : Hides the toolbar (along the top of DrScheme’s window) and the status line (along the bottom).
Show Profile : Shows the current profiling report. This menu is useful only if you have enabled profiling in the Choose Language... dialog’s Details section. Profiling does not apply to all languages.
Hide Profile : Hides any profiling information currently displayed in the DrScheme window.
Dock Test Report : Like the dock button on the test report window, this causes all test report windows to merge with the appropriate DrScheme window at the bottom of the frame.
Undock Test Report : Like the undock button on the test report window, this causes the test reports attached to appropriate DrScheme tabs to become separate windows.
Show Tracing : Shows a trace of functions called since the last time Run was clicked. This menu is useful only if you have enabled tracing in the Choose Language... dialog’s Details section. Profiling does not apply to all languages.
Split : Splits the current window in half to allow for two different portions of the current window to be visible simultaneously.
Collapse : If the window has been split before, this menu item becomes enabled, allowing you to collapse the split window.
Note: whenever a program is run, the interactions window is made visible if it is hidden.
3.1.4 Language
Choose Language... : Opens a dialog for selecting the current evaluation language. Click Run to make the language active in the interactions window. See Choosing a Language for more information about the languages.
Add Teachpack... : Opens a find-file dialog for choosing a teachpack to extend the current language. Click Run to make the teachpack available in the interactions windows. See Extending DrScheme for information on creating teachpacks.
Clear All Teachpacks : Clears all of the current teachpacks. Click Run to clear the teachpack from the interactions window.
In addition to the above items, a menu item for each teachpack that clears only the corresponding teachpack.
3.1.5 Scheme
Run : Resets the interactions window and runs the program in the definitions window.
Limit Memory... : Allow you to specify a limit on the amount of memory that a program running in DrScheme is allowed to consume.
Clear Error Highlight : Removes the red background that signals the source location of an error.
Create Executable... : Creates a separate launcher for running your program. See Creating Executables for more info.
Module Browser... : Prompts for a file and then opens a window showing the module import structure for the module import DAG starting at the selected module.
The module browser window contains a square for each module. The squares are colored based on the number of lines of code in the module. If a module has more lines of code, it gets a darker color.
In addition, for each normal import, a blue line drawn is from the module to the importing module. Similarly, purple lines are drawn for each for-syntax import. In the initial module layout, modules to the left import modules to the right, but since modules can be moved around interactively, that property might not be preserved.
To open the file corresponding to the module, right-click or control-click (Mac OS X) on the box for that module.
Reindent : Indents the selected text according to the standard Scheme formatting conventions. (Pressing the Tab key has the same effect.)
Reindent All : Indents all of the text in either the definitions or interactions window, depending on the location of the selection or blinking caret.
Comment Out with Semicolons : Puts ; characters at each of the beginning of each selected line of text.
Comment Out with a Box : Boxes the selected text with a comment box.
Uncomment : Removes all ; characters at the start of each selected line of text or removes a comment box around the text. Uncommenting only removes a ; if it appears at the start of a line and it only removes the first ; on each line.
Disable Tests : Stops tests written in the definitions window from evaluating when the program is Run. Tests can be enabled using the Enable Tests menu item. Disabling tests freezes the contents of any existing test report window.
Enable Tests : Allows tests written in the definitions window to evaluate when the program is Run. Tests can be disabled using the Disable Tests menu item.
3.1.6 Insert
Insert Comment Box : Inserts a box that is ignored by DrScheme; use it to write comments for people who read your program.
Insert Image... : Opens a find-file dialog for selecting an image file in GIF, BMP, XBM, XPM, PNG, or JPG format. The image is treated as a value.
Insert Fraction... : Opens a dialog for a mixed-notation fraction, and inserts the given fraction into the current editor.
Insert Large Letters... : Opens a dialog for a line of text, and inserts a large version of the text (using semicolons and spaces).
Insert λ : Inserts the symbol λ (as a Unicode character) into the program. The λ symbol is normally bound the same as lambda.
Insert Java Comment Box : Inserts a box that is ignored by DrScheme. Unlike the Insert Comment Box menu item, this is designed for the ProfessorJ language levels. See ProfessorJ.
Insert Java Interactions Box : Inserts a box that will allows Java expressions and statements within Scheme programs. The result of the box is a Scheme value corresponding to the result(s) of the Java expressions. At this time, Scheme values cannot enter the box. The box will accept one Java statement or expression per line.
Insert XML Box : Inserts an XML; see XML Boxes and Scheme Boxes for more information.
Insert Scheme Box : Inserts a box to contain Scheme code, typically used inside an XML box; see XML Boxes and Scheme Boxes.
Insert Scheme Splice Box : Inserts a box to contain Scheme code, typically used inside an XML box; see also XML Boxes and Scheme Boxes.
Insert Pict Box : Creates a box for generating a Slideshow picture. Inside the pict box, insert and arrange Scheme boxes that produce picture values.
3.1.7 Windows
Bring Frame to Front... : Opens a window that lists all of the opened DrScheme frames. Selecting one of them brings the window to the front.
Most Recent Window : Toggles between the currently focused window and the one that most recently had the focus.
Additionally, after the above menu items, this menu contains an entry for each window in DrScheme. Selecting a menu item brings the corresponding window to the front.
3.1.8 Help
Help Desk : Opens the Help Desk. This is the clearing house for all documentation about DrScheme and its language.
Tool Web Sites : Provides links to web sites for installed tools.
Interact with DrScheme in English : Changes DrScheme’s interface to use English; the menu item appears only when the current language is not English. Additional menu items switch DrScheme to other languages.