.TUTORIAL - Adding Hint Text

The only difference between this and the prior program is the
addition of hint text.  The ";;" (double semi-colon) is used to
denote that hint text follows.  The "@@" (double "at" sign) denotes a
comment.

SHAZAM uses an easy-going, lazy man's syntax; ie:  "Use it if you
feel like it, but nothing's required."  In general, syntax is used
mostly for [ SUBMENU ] and [ STATUS ] keywords.  In full form, it
looks like:

|   [ SUBMENU ] label param kbXX cmXX hcXX   ;;hint text  @@ comment
|   label param kbXX cmXX hcXX               ;;hint text  @@ comment

...for [ STATUS ] contexts, like this:

|   [ STATUS ] hcXX , hcXX                 @@ comment
|   param label kbXX cmXX                  @@ comment

If a "label" has whitespace, enclose in quotes.

Most times, you don't need much syntax.  SHAZAM extrapolates the
"label" or "param" to figure out the kbXX, cmXX and hcXX symbols.  If
you provide a symbol, it overrides what SHAZAM extrapolates.  This is
useful in rare cases, when SHAZAM gets befuddled by a prefix of "cm",
"kb" or "hc", like this:

|   [submenu] info               ;;PC-AT battery stuff
|   CMOS Alt-F5                  ;;chokes on CMOS
|   CMOS Alt-F5 cmXCMOS hcXCMOS  ;;CMOS without choke

Please see KEYWORD REFERENCE for more information.


OBSERVATIONS
------------
1.  When you run this program, the hints appear on the StatusLine.

2.  Select a menu item.  When the MsgBox appears, press Ctrl-F5.
    SHAZAM has mapped the same default Key-to-Command as APP.PAS.

3.  Press F1 for Help; note that a dummy help text file (*.TX) was
    created from hint text, so the Help Compiler has something to do.

    When you're ready to start working on help text, change the
    SETUP|Code|Help text to "Append" and regenerate.  This will
    create a permanent *.TXT file using Hint Text for Help Text, to
    give you a leg up on the help system.

@PA - - - - - - - - - - - - - - - - - - - - - - - - - - - -



[ SUBMENU ] File        ;;file management        @@ these are hints
Open                    ;;open a file
Save                    ;;save current window
