HOWTO: Epsilon firmware macro definitions
metalliqaz@geekhack

==========
Overview
========

Current Macro limits:
    4 macros
    80 characters per macro
    unlimited mods per character

Macro strings are specified as strings of characters that should be typed by the
keyboard as if the keys were struck by hand.

Note, it is not necessary to manually use shift to get capital letters.  The
system knows enough to replace "A" with "\SHIFT(a)" and "+" with "\SHIFT(=)".
(See below for more on the use of modifier keys)
 
The escape character is backslash (\).

There are a few special escape sequences, which must be followed by a comma.
backslash: \\,
newline: \n,
tab: \t,

Non printed keys are defined as an escaped string followed by a comma.  For
example:

\HOME,
\TAB,
\F5,

See the list at the bottom of this document.

Mods are specified with an escaped string followed by a string enclosed in
parenthesis.  The modifier key will be held for the entire sub-string.  For
example:

\SHIFT(hello, world!)
\CTRL(\ALT(\DEL,))

Note that this means you can't use a mod on ")" because it would be interpreted
as the end of the sub-string.  But, why would you want to do that?
Just use a zero, "0".  They, ")" and "0",  are the same key.


==========
Specials
========

Mod keys:

CTRL       (synonym for LCTRL)
SHIFT      (synonym for LSHIFT)
ALT        (synonym for LALT)
WIN        (synonym for LWIN)
LCTRL
LSHIFT
LALT
LWIN
RCTRL
RSHIFT
RALT
RWIN

Non-printable keys:

ESC
F1 through F12
PRINT
PAUSE
SCRLK
NUMLK
CAPSLK
INS
DEL
HOME
END
PGUP
PGDN
TAB
BKSP
ENTER
UP
DOWN
LEFT
RIGHT
SPACE
APP

Media keys:

MUTE
VOLUP
VOLDN
BASS
NEXT
PREV
STOP
PLAY


==========
Examples
========

To get something like this:

John Doe
123 Main St.
NEW YORK NY 12345

Macro string could be:

John Doe
123 Main St.
\SHIFT(New York NY) 12345

or it could be:

John Doe\n,123 Main St.\n,\SHIFT(New York NY) 12345\n,

To get something like this:

Col A		Col B		Col C

You could use something like this, if you wanted:

Col A		Col B\TAB,\TAB,Col C\n,

