APLX KEYMAPS

Special APL symbols are typed into the APLX session window or editor windows
using "Shift", "Alt" or "Shift+Alt" key combinations. To determine which
symbol should be produced by a given key, APLX uses a table called a "keymap".


BUILT-IN KEYMAP TABLES

APLX includes built-in default keymap tables for the following nationalities.
If no custom keymap file is selected in the preferences, APLX selects the 
built-in table according to the user's $LANG environment variable (shown in
square brackets)

    English (UK)            [en_GB]
    English (US)            [en_US]
    English (Canadian)      [en_CA]
    French (Canadian)       [fr_CA]
    French (France)         [fr_FR]
    French (Belgian)        [fr_BE]
    French (Swiss)          [fr_CH]
    German                  [de_DE]
    German (Swiss)          [de_CH]
    Italian                 [it_IT]
    Dutch                   [nl_NL]
    Danish                  [da_DK]
    Finnish                 [fi_FI]
    Swedish                 [sv_SE]
    Norwegian               [no_NO]
    Spanish (Spain)         [es_ES]
    Spanish (Argentina)     [es_AR]
    Spanish (Chile)         [es_CL]
    Spanish (Columbia)      [es_CO]
    Spanish (Costa Rica)    [es_CR]
    Spanish (Ecuador)       [es_EC]
    Spanish (Mexico)        [es_MX]
    Spanish (Nicaragua)     [es_NI]
    Spanish (Peru)          [es_PE]
    Spanish (Venezuala)     [es_VE]


If there is no built-in table for the current $LANG, APLX uses the default
built-in US International keymap.


CUSTOMIZED KEYMAP TABLES

APLX includes a keymap editor window which can be used to change which APL
symbols are produced for each key. To use the keymap editor, select
"Preferences..." from the "Tools" menu, change to the "Keyboard" tab of
the dialog, and press the "Customize" button to create a new custom keymap
or edit an existing custom keymap.

Unfortunately, the keymap editor window is only available for the
nationalities listed above. For other nationalities, only those keys which
produce symbols available on the US International keyboard will be available.
In these cases, you should either choose a supported nationality which has
a similar keyboard layout to yours, or create a keymap file manually. To use
a keymap of another nationality, you should modify the "startaplx" script to
set the $LANG environment variable appropriately before starting APLX.

A keymap file comprises an N by 6 array of 16-bit integers. The first column
is the Keysym value of the key to be re-mapped. The other columns are the
positions in Quad-AV for the key for Unshifted, Shifted, Alt, Shift-Alt and
Caps-Lock. The last row of the table must be all zeroes.  Any keys which are
not re-mapped will produce whatever characters they normally do outside APL
(though they may not display correctly in the APLX fonts).

Standard X-windows tools "xmodmap" and "xev" can provide useful information
when creating a keymap file by hand.

    xmodmap -pk
    
displays all the keysym values currently configured for your keyboard.

    xev &
    
is an X-windows event monitor, which can give the keysym value for a key
when it is pressed.

To use your keymap file in APLX, select "Preferences..." from the "Tools"
menu, change to the "Keyboard" tab of the dialog, then press the "Browse"
button to locate the file.

