Click above to get retro games delivered to your door ever month!

  !File: - Reference to Another File

    Purpose
    The !file: command is used to point to a body of text that already exists
    in the Help File. This eliminates the need for incorporating multiple
    copies of the same text.

    The !file: command has three implementations:

    1. Use the !file: command when you wish to create a short topic that
       points to a list of short topics in a separate file.

       Format:
         !short: <text that describes the "pointed to" subject matter>  
         !file: filename.eho                                            
   
    2. Use the !file: command when you wish to create a Short Topic that
       points a Long Entry that belongs to a Short Topic in a separate file.

       Format:
         !short: <text that describes the "pointed to" subject matter>  
         !file: filename.eho:KEYWORD                                    
         ...where keyword is text fragment of the targeted short topic.

    3. Use the !file: command when you want to create a Short Topic that
       points to a single Long Entry that is located in a separate file.

       Format:
         !short: <text that describes the "pointed to" subject matter>  
         !file: filename.eho                                            

    Format Example 2:
    This variation of the !file: command lets you jump directly from a
    short topic into a long entry or short topic list that belongs to
    another ".EHO" file. If you jump to a long entry directly under
    to specified short topic, you are able return to the original
    short topic by pressing the <ESC> key. This version of the !file:
    command is very useful for creating an index for a Help File.

    Notes on using Format Example 2:
         Once you have jumped to the specified long entry, you can
         move to other LONG entries that are related to the topic
         via the RELATED TOPICS menu. You can also move to PREVIOUS
         or NEXT long entries via the Grey +/- keys. If you want to
         return to the ORIGINAL short topic, you must return to the
         original long entry before pressing the <ESC> key. If you
         press <ESC> while in a another long entry you will surface
         at the short topic that owns that particular long entry.
         
    The following examples demonstrate how the !file: command is
    implemented:

    1. An example of accessing a list of short topics:

         !short: Top Ten Hits from 1960 - 1989.                         
         !file: top_ten.eho                                             

    2. An example of accessing a single long entry.

         !short: Line Drawing Chart                                     
         !file: line_drw.eho                                            

    3. An example of accessing a long entry that belongs to a short
         topic in another EHO file:

         !short: Top Forty Hits from 1960 - 1989.                        
         !file: top_forty.eho:"1960 - 1989"                              


    Note:
         You must specify the compiled object file, which will have the
         .EHO extension. The !file: command, like all other bang commands,
         must be typed starting in column 1.
         
         Each !file: command MUST be preceded by a !short: command.
         !file: command CANNOT exist without a parent !short: entry.



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