The Configuration Dialog Box

The Configuration dialog box is displayed from the Session by selecting Configure from the Options menu. It presents many of the interpreter's configuration parameters, grouped into tabs; changing a setting and clicking OK updates the corresponding parameter. Each tab is described in its own section.

Some tabs are present only in the Unicode edition or only in the Classic edition, as noted in their headings.

General Tab

Unicode Input Tab (Unicode)

Unicode Edition can optionally select your APL keyboard each time you start APL. To choose this option, select one of your installed APL keyboards, enable the Activate selected keyboard checkbox, then click OK.

Input Method Editor Properties Dialog Box

Input Tab (Classic)

Output Tab (Classic)

Keyboard Shortcuts Tab

To alter the keystroke associated with a particular action, simply select the action required and press the keystroke. For example, to change the keystroke associated with the action <UA> (undo all changes) from (None) to Ctrl+Shift+u, simply select the corresponding row in the list and press Ctrl+Shift+u. If Confirm before Overwrite is checked, you will be prompted to confirm or cancel before each and every change is written back to the registry.

Clicking on the column headings sorts on that column; shift and mouse click will sort in reverse order.

Saved Responses Tab

The Saved Responses tab of the Configuration dialog is used to remove preferences that the user has previously established.

In this example, the user has at some point chosen to save a text file with a .h extension as text in the workspace and, by checking the option Save this response for all files with a ".h" extension, saved this as a preference for all such text files. Similarly, the user has checked the option Do not show this message again when responding to the warning dialog Saving as text will ....

If the user wants to reverse these decisions, even temporarily, it is necessary to select the corresponding option /preference name(s) and click Delete. The names are intended to be self-explanatory and are not listed here.

Workspace Tab

Help/DMX Tab

Windows Tab

Session Tab

The size-related values in the Session tab are specified as an integer value followed by one of K, M, G, T, P, or E. Where no character is included, the default is K (kilobytes).

Trace/Edit Tab

Fixing Scripts

When using the Editor to edit a script such as a Class or Namespace you can specify whether, when you Fix the script and Exit the Editor, just the functions in the script are re-fixed, or whether the whole script is re-executed, thereby re-initialising any Fields or variables defined within.

These two actions always appear in the Editor File menu, but you can specify which is associated with the <EP> Esc key by selecting the appropriate option in the drop-downs labelled:

• Exit and save changes <EP> in a suspended class or namespace should fix:
• If not suspended fix:

In both cases, you can select either Only Functions or Everything.

The label for the corresponding items on the Editor File menu (see The File Menu (editing a script)) will change according to which behaviour applies. If you specify a keystroke for <S1> in the Keyboard Shortcuts tab, this will be associated with the unselected action.

Auto Complete Tab

To enter values in the OK Key and Cancel Key fields, click on the field with the mouse and then press the desired keystroke.

SALT Tab

SALT is the Simple APL Library Toolkit, a simple source code management system for Classes and script-based Namespaces. SPICE uses SALT to manage development tools that "plug in" to the Dyalog session.

User Commands Tab

This page is used to specify and organise a list of folders that contain user command files. When you issue a user command, these folders will be searched for the source of the command in the order in which they appear in this list.

Object Syntax Tab

The Object Syntax tab of the Configuration dialog is used to set your default preferences for Object Syntax. Use Options/Object Syntax to change the settings for the current workspace.