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

  !Seealso: Cross Referencing:
    Our two long entries contain related data. We have a command called
    !seealso: that makes it easy to find related text within a help file.
    The !seealso: command allows you to point to entries that are
    related to the current topic.

    The !seealso: command can create links between a long entry and...
       A long entry underneath a short topic in the same file (.EHO)

       A long entry underneath a short topic in the separate file (.EHO)

       A single long entry in the separate file (.EHO)

       A short topic list in a separate file (.EHO)

    The !seealso: command is implemented by positioning it after the long
    entry but before the next !short: command. The !seealso: command must
    begin in column 1 with all related keywords typed on the remainder of
    the !seealso command line. A !seealso command line must be no longer
    than one line in length.

          The following combination has no effect. This is because there is
          no Long Text defined after the !short: command.

                       !short: <topic>
                       !seealso: <keyword>

    Within a help file structure, you can cross reference to entries anywhere
    in the entire file. The format for locating each type of long entry are
    slightly different and goes like this.

    1. When referring to a long entry within the same compiled file:

            !seealso: keyword1 keyword2 keyword3

    If the pointer to a single reference is more than one keyword (IE:
    "Key Word 1" "Key Word 2") you must surround the keywords with
    double quotes. The reference would then go like this.

    !seealso: "Key Word 1" "Key Word 2"

    2. When referring to a long entry in another compiled file:

            !seealso: SOURCE2.EHO:keyword1

            !seealso: SOURCE2.EHO:"key word 1"

    Note: There must be no blank spaces between the colon and the :keyword1
                        +-------------+                           |+ 

    3. When referring to a short topic list or single long entry in
       separately compiled file:

            !seealso: SOURCE2.EHO:"Your choice of text"

    Let's add a seealso reference. Add a seealso reference at the end of
    SOURCE2.TXT. Your file should now look like this:

                To compile a data text source file,                     
                type EHC, followed by a list of                         
                the files to be compiled. The compiler                  
                outputs object files with the dame name                 
                as the input files, and the extension                   
    !seealso: SOURCE1.EHO:"Creating Source"                             

    Since our !seealso command is referring to text contained in another
    compiled file, we must also specify the name of the compiled file.
    Also, we must surround our !seealso reference with double quotes since
    it requires more than one word to identify it properly.

    Once compiled and linked our seealso reference will cause the Expert Help
    engine to display a...
                    Related Topics: 

    reference pointing to
                   Creating Source.

    Notice that we included only the first part of the short topic text of
    the entry this seealso refers to.
            The full short topic reads:
                   Creating Source Files   An Overview.

    The !seealso: command only requires enough text to uniquely identify
    the short topic that the !seealso is targeting.

    Save this file as SOURCE2.TXT.

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


See Also: Long Entries !Short:

Online resources provided by: --- NG 2 HTML conversion by Dave Pearson