APPENDIX H
KEY LABEL ABBREVIATIONS

When creating a key label dictionary, enter the name of the key you wish
labeled on the first line of a standard ASCII text file.  Enclose the key in
brackets [].  Then, on the next line, enter the label you wish voiced
whenever the labeled key is pressed.

Many key names use abbreviations when used as a part of a key label
dictionary.  Users of ProKey and other macro processors may already be
familiar with many of these standard key abbreviations.  Below is a list of
keys and the abbreviations used to represent them.

[CTRL], [ALT] and [CAPS]:  These abbreviations represent the three "shifted"
keyboard states of Control, Alt and Shift respectively.  Enter the abbreviation
as is and without blank spaces to represent the "shifted" state of any key. 
CTRL-F1, for instance, would appear as [CTRLF1], ALT F2 as [ALTF2], and
SHIFT F3 as [CAPSF3].  It does not matter whether you enter the
abbreviations in upper or lower case letters.  Vocal-Eyes will accept either.

You do not have to use one of the shifted states.  For example, you could
have an entry like [F1] which would simply mean the F1 key by itself. 
However, if you wish to use a shifted state, you can only use one at a time. 
For example, [ALTCAPSF1] is invalid.  You cannot have ALT-SHIFT-F1.  You
could have ALT-F1 or SHIFT-F1 but not both at the same time.

Keyboard keys and abbreviations

[A] through [Z] - Standard letters
[0] through [9] - Standard keyboard numbers
[~] - Tilde
[`] - Grave Accent
[!] - Exclamation point
[@] - At sign
[#] - Number sign
[$] - Dollar sign
[%] - Percent sign
[^] - Carrot
[&] - Ampersand
[*] - Asterisk
[(] - Left paren
[)] - Right paren
[_] - Underline
[-] - Dash
[+] - Plus sign
[=] - Equal sign
[{] - Left brace
[}] - Right brace
[[] - Left bracket
[]] - Right bracket
[|] - Vertical bar
[\] - Backslash
[:] - Colon
[;] - Semicolon
["] - Quote
['] - Apostrophe
[,] - comma
[<] - Less than
[.] - Period
[>] - Greater than
[/] - Slash
[?] - Question mark
[SPACE] - Space bar

[F1] through [F12] - Function keys

[ENTER] - Normal keyboard ENTER
[ESC] - ESCAPE
[TAB] - TAB
[BKS] - Backspace
[SCROLL] - Scroll lock key

[K0] through [K9] - Keypad number keys
[K*] - Keypad asterisk
[K/] - Keypad slash
[K-] - Keypad dash
[K+] - Keypad plus
[K.] - Keypad period
[KENTER] - Keypad enter
[LFT] - Keypad left arrow
[RGT] - Keypad right arrow
[UP] - Keypad up arrow
[DN] - Keypad down arrow
[HOME] - Keypad home
[END] - Keypad end
[PGUP] - Keypad pageup
[PGDN] - Keypad pagedown
[DEL] - Keypad delete
[INS] - Keypad insert
[CTR] - Keypad center key (5)

[CLFT] - Cursor pad left arrow
[CRGT] - Cursor pad right arrow
[CUP] - Cursor pad up arrow
[CDN] - Cursor pad down
[CHOME] - Cursor pad home
[CEND] - Cursor pad end
[PAGEUP] - Cursor pad pageup
[PAGEDOWN] - Cursor pad pagedown
[DELETE] - Cursor pad delete
[INSERT] - Cursor pad insert

Note:  If you do not have the enhanced 101-key keyboard or if you have one
but your system treats it like an older keyboard, you will not have access to
some of the above keys.  You will not be able to use the F11 or F12 keys,
nor any of the Cursor pad keys.  

Below are some examples using the above information:

[ALTA] - Stands for ALT-A
[CAPSDELETE] - Stands for SHIFT-cursor pad DELETE
[CTRLSCROLL] - Stands for CONTROL-SCROLL LOCK
[ALT0] - Stands for ALT-0 on standard keyboard
[ALTK0] - Stands for ALT-0 on keypad
[ENTER] - Stands for the standard ENTER key only
[KENTER] - Stands for the ENTER key on the keypad only
[-] - Stands for the dash key
[ALT-] - Stands for ALT-DASH
[CUP] - Stands for the up arrow key on the cursor pad
[UP] -Stands for the up arrow key on the keypad

Below is a listing of an actual key label dictionary.  This is a small example
of what you could do for WordPerfect:

[F1]
cancel
[CAPSF1]
setup
[ALTF1]
thesaurus
[CTRLF1]
shell

As you can see, this covers all of the F1 combinations for WordPerfect 5.1. 
This would tell Vocal-Eyes to speak "CANCEL" when the F1 key is pressed,
"SETUP" when SHIFT-F1 is pressed, "THESAURUS" when ALT-F1 is
pressed, and "SHELL" when CTRL-F1 is pressed.  Remember, you can have
Vocal-Eyes speak anything you want by placing the verbal text immediately
after the key definition.  You are limited only by the buffer space you
allocated when you started up Vocal-Eyes.  The key label buffer defaults to
1024 bytes or characters.  

