Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Expert Help On-Line Manual v1.30 - Norton Guide http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]

    Related Topics:  -  !Seealso: (Cross Referencing).

    Purpose
    The !seealso: command links a Long Entry to other topics that are
    related to it. If there are any !seealso's defined for a long entry,
    Related Topics: will appear in the top left corner of the Long Entry
    window. When ENTER is pressed, a pull-down menu will appear with the
    names of the references as menu items. Scroll to the topic of your
    choice and press ENTER. The new topic will appear instantly on your
    screen. The following examples demonstrate the three ways that a
    !seealso: can be defined.
     
    1. To reference a Short Topic within the same data source file.

      Format:
         <long entry text>                                              
         !seealso: key-word(s) [space...keyword(s)]                     

      Where
         key-word(s) is "text-from-a-short-topic"

    2. To reference a Short Topic in a separate data source file.

      Format:
         <long entry text>                                              
         !seealso: filename.eho:key-word(s) [space...keyword(s)]        

      Where
         key-word(s) is filename.eho:"text-from-a-short-topic"

    3. To reference a single Long Entry in a separate data source file.

      Format:
         <long entry text>                                              
         !seealso: filename.eho:key-word(s) [space...keyword(s)]        

      Where
         key-word(s) is filename.eho:"user defined seealso-title"

    Notes:
         !seealso:, like all other bang commands, must be typed starting in
         the leftmost screen column 1. You can have up to 20 keywords on
         a !seealso: command line. If you are referencing an entry in a
         separate file, the filename.eho: must precede each reference
         on the !seealso: command line.

    The text-from-a-short-topic must appear at the start of the entry
    that expands to the long entry you want. The text can be any number of
    words, starting at the beginning of the short topic. Each reference must
    be separated by space character. The short topic can be either in the
    current data text file, or another data text file.

    The third format of !seealso: allows you to include a reference to any
    entry that exist as long text by itself in a separate ".EHO" file. In
    this case, there's no short topic description from which to reference
    for the Related Topics: menu, so you simply make up the text for
    the user defined seealso-title. With this method you can specify
    jumps to a single Long Entry or a Short Topic list.

    You do not need to use the entire text of the short topic. For example,
    if the long entry you are referring to is under a short topic that
    reads:

         !short: Jalapeno  A pepper often used when making nachos.      

    your seealso could read:

         !seealso: "Jalapeno  A pepper"                                 

    or

         !seealso: Jalapeno                                             

    Note:
         You need only include enough text to uniquely identify the short
         topic. The text must, however, be taken from the beginning of the
         entry. When scanned for a match during linking, the scan is not
         case sensitive. Beginning spaces, character and color attributes
         are removed (^Cxx and ^Axx) from the short topic before being
         compared the seealso text.

    Multiple references in a single !seealso: command are separated by one or
    more spaces or tabs. If the key-words text includes embedded spaces,
    tabs, or colons, it must be enclosed within double quotation marks. Use
    two quotations marks to enter a single quotation mark into the key-words
    itself.

    The key-words text can come from a short topic either in the same file,
    or in a different file. To indicate a reference to a short topic in
    another file, precede the key-words text with the filename, as in:

         !seealso: chart.eho:"Reference Chart"                          


    Press the Gray + key to Jump to the next topic (long entry).

 

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson