Noted Tuesday, November 25, 2014:

From WordStar 7.0D README.TXT, this is why WordStar
doesn't like macro names that begin with a hyphen 
or underscore:

Changing Function Key Labels

The names for Function Key Labels are based on the filenames
of the macros that are assigned to them.  The first letter is
capitalized and the rest are in lower case.

-  To force the next letter to be capitalized, use an underscore
   in the macro filename.
-  To insert a space and capitalize the next letter, use a hyphen
   in the macro filename.



================================================================= 

MACROS

Assigning Macros to the F11 and F12 Function Keys

As a default, WordStar doesn't let you assign macros to the F11
and F12 function keys.  If your keyboard has these function keys
and you want to assign macros to them, use WSCHANGE (ADC) to
turn on extended keyboard support.

Changing the Function Keys for HELP and DONE

If the standard settings of F1 (for HELP) and F10 (for DONE)
conflict with keys you have already defined, you can
change the settings by patching U1FKEY and U2FKEY.

To change the key for HELP, patch U1FKEY to the use the two-byte
scan code of the key you want to use. The default is 3B00H.
For example, to change HELP to F5 (scan code 3F00H), patch U1FKEY to
00 3F. (Note that the low byte, 0, is entered first.)  The
description string follows in the next 8 bytes.  The default setting
is "Help."

To change the key for DONE, patch U2FKEY to use the scan code of the
key you want to use.

Displaying Function Key Labels

You can display function key labels at the bottom of the screen.
These labels show the first six characters of the corresponding
macro filenames.  To turn on display of labels, use WSCHANGE
(DBA2K).

Changing Function Key Labels

The names for Function Key Labels are based on the filenames
of the macros that are assigned to them.  The first letter is
capitalized and the rest are in lower case.

-  To force the next letter to be capitalized, use an underscore
   in the macro filename.
-  To insert a space and capitalize the next letter, use a hyphen
   in the macro filename.

Function Key Colors

Function key colors, by default, are linked to menu colors.  The
function key numbers are linked to the status line highlight color.

You can change the color mappings using the label patcher in
WSCHANGE.  Two bytes define each color.  The values below define
how to link the function key colors to one of the WordStar screen
color settings.

-  To change the color of the function key descriptions, use
   the FCOLOR label.

   To link function key colors to another WordStar screen color
   choose the appropriate number (in hex, for the label patcher)
   from the following list:

   00 00: default
          display name: maps to menu color
          function key number: maps to status line highlight
   01 00: maps to strikeout colors
   02 00: maps to normal text colors
   04 00: block mark settings of these text attributes when added
          to the values with a zero second byte. For example,
          14 00 gives a subscript color when it's in a block of
          marked text.
   08 00: maps to underline color

   10 00: maps to subscript color
   20 00: maps to superscript color
   40 00: text bold (also used for highlight if added to values with
          a non zero second byte.  For example, 40 08 gives button
          highlight color.
   80 00: maps to italic color

   00 01: maps to normal text color (same as 2)
   00 02: maps to title line color
   00 04: maps to menu color
   00 08: maps to button bar color

   00 10: maps to ruler line color
   00 20: maps to status line color
   00 40: maps to flag column color

-  To define the colors for the function key numbers, use FCOLOR+2
   and FCOLOR+3.  Use the same values used for the function
   key descriptions above.

   For example, to change the function key color to be the same as
   the button bar, and to change the numbers to be the same
   as marked subscript text, you can use the label patcher to patch
   FCOLOR to: 00 08 14 00

   In other words, use 00 08 for the button bar and 14 00 for the
   numbers.

Disabled Mouse in Macros

The mouse is usually disabled while you're recording a macro in
WordStar.  Although the mouse is functional in Preview, the mouse
commands aren't recorded.
