!Short:                 Define a Short Entry
 
  Purpose
 
    Short entries provide a concise summary of a topic and serve as an
    easy-to-scan pointer to a more complete description.
 
  Format
 
         !short:[line-of-text]
         text of long entry
         [!seealso: references]
 
    or
 
         !short:[line-of-text]
         !file: filename
 
  Description
 
    A short entry is a single line of text. Short entries generally
    appear as part of a list with other short entries; the list can be
    thought of as an index into longer, more complete descriptions. These
    underlying long descriptions are accessed via the Expand menu of the
    Norton Guides.
 
    A short entry can point to either a single long entry, or to another
    list of short entries (see the description of !file for the details
    on the latter).
 
    A short entry must begin with the command !short:, starting in column
    1. All text after the colon, including spaces and tabs, will appear
    in the text of the short entry in the database, exactly as it was
    typed into the source file (with the exception of the special
    handling of ^ character sequences, described under Character
    Attributes).
 
  Tips and Suggestions
 
    To create an attractive and easy-to-scan list of short entries, you
    may wish to insert empty (blank) short entries at critical points
    within the list. Although you will be able to move the highlight bar
    to the blank lines, they will have no other functional effect (as
    long as nothing is defined under them).