           This is the instruction manual for HyperRead and
        HyperRead Generator. It is also a demonstration HyperRead
        file. You can flip through this document one page at a time
        using the <PgUp> and <PgDn> keys. You can move one line at
        a time by holding down the Ctrl key as you press <PgUp> or
        <PgDn>. You can also move through the document by pressing
        the up or down cursor key. If the screen cursor gets to the
        top or bottom of the screen and you continue pressing the
        cursor key, the text will scroll. You can move to the top
        of the document by pressing the <Home> key on your
        keyboard, or go to the end of the document by pressing the
        <End> key.
           You also can jump around in the document using the link
        words or phrases. Link phrases look like this. To jump to a
        section of text containing more information on a link
        phrase, use the cursor keys to move the screen cursor to
        the link phrase, then press the <J> key on the keyboard.
        You may do this repeatedly, going from one link word to
        another. You can backtrack along this path by pressing the
        <B> key on the keyboard. There is more information on this
        "jumping" later in this document.
           You can also control HyperRead Generator using a mouse
        if you have one installed. This will be explained later (or
        you can jump to this subject now by jumping from the word
        "mouse" and then backtracking to this page when you are
        done).
           You may now read the manual. Enjoy, and feel free to
        experiment with the link phrases.

           Every few years, a new concept comes along that offers a
        whole new use for personal computers. Typical examples have
        been word processing, telecommunications and BBS's,
        spreadsheets, and desktop publishing. The latest new idea
        is hypertext.
           What is hypertext? It is an indexing system that allows
        people to use their computers to read computer text files
        quickly and easily. It does this by allowing them to jump
        from one part of the file to another, following whatever
        train of thought they want.
           In an ordinary printed document, the reader must read
        the document linearly. That is, the person must read from
        the beginning to the end, one page at a time. Sometimes the
        person can jump around a little by using the index or the
        table of contents, but this is very limited. The index can
        only list a few key words, and the pages listed for those
        words are usually simply where the word is defined or first
        mentioned. The table of contents points only to broad areas
        of the document where a general subject is discussed. In
        any case, flipping through the pages is time-consuming and
        tedious.
           With hypertext, the author of a document can create
        "tunnels" or links within a document that allow the reader
        to jump from one area of the document to another. The
        reader uses a computer to read the text on the screen. When
        he or she finds an important word or phrase in the text
        that needs clarifying, the computer can jump to the part of
        the text that explains the term or gives more information.
        For example, suppose you are reading a story about the
        history of the electric light bulb. The story mentions that
        it was invented by Thomas Edison. If you get curious about
        Edison, you can jump directly from that part of the text to
        the part that tells you more about Edison. That part of the
        text might mention some of Edison's other inventions. If
        you see one that looks interesting, you can jump directly
        to the part of the text that describes this invention. This
        can vastly increase the speed at which you can find
        information.
           HyperRead Generator and HyperRead are programs that
        allow you to create and distribute hypertext documents.
        HyperRead Generator allows you to convert an ordinary ASCII
        text file into a hypertext document, which you may then use
        or distribute. This program is shareware. It can be
        downloaded from various Bulletin Board Systems or ordered
        directly from Leithauser Research or a qualified
        distributor. HyperRead is the program that allows you to
        read the hypertext documents. This program is freeware, and
        you may distribute it freely with any HyperRead files you
        create. Both programs can be used with or without a mouse.
           Before explaining how to use HyperRead Generator, an
        explanation of how to operate HyperRead will be helpful.
        This is partly because the person who reads the document
        will be using HyperRead, so a thorough understanding of
        HyperRead is important to anyone who plans to use
        HyperRead Generator to create HyperRead files. It is also
        helpful to understand HyperRead because HyperRead
        Generator operates almost identically to HyperRead,
        except that it has some extra functions and is missing a
        few minor ones from HyperRead.

        Using HyperRead

           To read a HyperRead file, you need only run HyperRead
        and load the desired HyperRead document. There are two ways
        you can do this. You can simply type the program name (HR5)
        at the DOS prompt. If there are more than one HyperRead
        files in the current default directory, the computer will
        then display a list of HyperRead files and ask you which
        file to load (Otherwise it simply loads the one file). Type
        the name of the file and press the ENTER key. Note: All
        HyperRead documents actually consist of two files. There is
        a text document file that can have any name and extension.
        There is also a control file that has the extension HRF. It
        is not necessary to type this extension to load the file.
        For example, to load the file GENERATE.HRF, just enter the
        name GENERATE.
           Another way to run HyperRead and load a file is to type
        the program name (HR5) followed by the name of the file to
        load at the DOS prompt. For example, this file is called
        GENERATE.HRF. You can run the program and load this file at
        the same time by typing HR5 GENERATE at the DOS prompt (it
        is not necessary to include the extension). This feature
        makes it easy to create a batch file that automatically
        runs the HyperRead program and loads a HyperRead file.
           When the program has loaded the file, it will display
        the first page of the file. At the bottom of the screen,
        you will see a list of options. These options are PgUp,
        Home, Help, Load, Quit, Jump, Backtrack, Search, Print,
        End, and PgDn. For the PgUp, PgDn, Home, and End options,
        press these keys on the keyboard. For the other options,
        press the first letter of the option. These options are
        explained below.

        PgDn

           Pressing the <PgDn> key moves the page of text on the
        screen to the next page. That is, it scrolls down 23 lines.
        If you hold down the <Ctrl> key while pressing the <PgDn>
        key, however, the screen will scroll only one line.

        PgUp

           Pressing the <PgUp> key scrolls the text up 23 lines. If
        you hold down the <Ctrl> key while pressing this key,
        however, the text will scroll only one line.

        Home

           Pressing the <Home> key moves you directly to the first
        page of the document. If you are in the middle of a long
        document, this can be a faster way to get to the beginning
        than repeatedly pressing <PgUp>.

        End

           Pressing the <End> key moves you to the last page of the
        document. If you want to get to a page near the end, you
        can press <End> and then <PgUp> a few times. This is
        sometimes faster than pressing <PgDn> repeatedly.

        Cursor Keys

           You can move the screen cursor with the cursor keys and
        also scroll through the document by moving beyond the top
        or bottom of the screen.

        Help

           This option displays a Help screen. This screen gives a
        short summary of the other options and how to use them.
        After viewing this help screen, you can press the space bar
        to return to the HyperRead document.

        Load

           This loads a document file into memory. The computer
        will display a list of HyperRead documents in the current
        directory. Type the name of the file and press ENTER. It is
        not necessary to include the extension. This option allows
        you to read several documents without returning to DOS to
        reload HyperRead and load a new document.

        Quit

           This option ends the programs and returns you to DOS.

        Jump

           This is the function that allows you to move directly to
        another area of the document that is pointed to by a link
        word or phrase. If you have a color screen, the default color
        for link words is blue on a black background. If you have a
        monochrome screen, default color for link words is black on
        a white background. You can change these at program startup.
           To select a link word, use the keyboard cursor keys to
        move the flashing screen cursor until it is somewhere on
        the link word. Then press the <J> key. The computer will
        then display the page of text pointed to by the link word.
        The page of text may be within the main body of the text
        or, starting with HyperRead version 5.5, it may be a
        separate section of text that can only be accessed with a
        Jump function. In either case, once you have
        jumped to this new page, you can move normally through the
        document using the <PgUp> and <PgDn> keys. You
        also can jump to other areas of the document from there
        using other link words. For example, suppose you jumped to
        a page using the link word "Thomas Edison" and that page
        contained the link word "light bulb." You could then jump
        directly to the page pointed to by "light bulb."
           If the link word is the name of a PCX picture file,
        "jumping" to it displays that picture on the screen. For
        example, moving the screen cursor to the word SATURN.PCX
        and pressing the <J> key will display a sketch of Saturn.
        Pressing any keyboard key (except control keys like Shift,
        Ctrl, or Alt) or either mouse button will return you to the
        document text.
           If the link word is an executable file name with an EXE,
        COM, or BAT extension, "jumping" to it will cause
        HyperRead to run that program (assuming that it exists in
        the current directory). For example, jumping from the word
        NOTHING.COM will run the NOTHING.COM program. When the
        program or batch file finishes running, HyperRead will
        come back and display the page it was on before you ran the
        program.

        Backtrack

           This function allows you to reverse the effects of the
        Jump function. When you press the <B> key, the computer
        will take you back to the page containing the most recently
        used link word. For example, if you jumped to a destination
        page using the link word "Thomas Edison," pressing the <B>
        key would take you back to the page containing "Thomas
        Edison."
           You can use the backtrack function repeatedly. For
        example, suppose you jumped to a page pointed to by "Thomas
        Edison" and that page contained the link word "light bulb."
        You then used the "light bulb" link word to jump to another
        page. Pressing the <B> key twice would jump back to the
        page containing "light bulb" and then to the page
        containing "Thomas Edison." You can repeat this process
        until you reach the page containing the first link word you
        used.

        Search

           This option allows you to search the document for a
        specific text string, such as a name. It is handy if you
        want to find information on a subject, and there is no link
        word on the screen that would take you to that subject.
           When you pick this option, the computer will ask you for
        the string of text to search for. Type the string and press
        ENTER. If you have already used this option, the default
        will be the last string you searched for. This allows you
        to easily continue the search if you want more information
        on the string.
           The computer will always begin the search at the line
        the screen cursor is on in the document. It does not find
        any appearances of the string that occur before this in the
        document.
           The search is case-insensitive. That is, it disregards
        capitalization. If you asked the computer to search for
        "home," it would find "home," "Home," and "HOME."
           The program searches each line of text for the search
        string. It will not find the string if it is broken by the
        end of a line. For example, if the string were "George
        Washington," the program would not find it if the text
        contained the word George on one line and Washington on the
        next. For this reason, it is best if you limit your search
        string to one word if possible.
           When the program finds the search string, it displays
        the page of text containing the string. The line containing
        the string will be at the top of the screen. If the
        document does not contain the string after the current
        screen cursor position, the program will display a message
        saying "String not found. Press space bar to continue."
        When you press the space bar, the text will be at the same
        point where you started the search.

        Print

           The Print function will send a copy of the document to
        the printer. If the document contains page feed characters,
        HyperRead will use those to format the document.
        Otherwise, HyperRead will create its own formatting. It
        will print out the document with margins at the top and
        bottom of the page and a page number at the bottom of each
        page.
           To use this feature, set the printer at the top of a
        page of formfeed paper, turn it on, and press the <P> key
        on the keyboard. This is intended primarily for people who
        are distributing HyperRead instructions for their Shareware
        or public domain programs. This makes it unnecessary to
        include a separate ASCII file of the instructions to print.

        Mouse Support

           If you have a mouse driver installed, HyperRead will
        support the mouse. If you have a mouse driver installed,
        you will have two cursors on the screen. One is controlled
        by the mouse and one is controlled by the keyboard cursor
        keys. The mouse cursor is somewhat darker in color. You
        might need to move the mouse around a bit to help you find
        the mouse cursor.
           You can use the mouse to operate the HyperRead
        navigation functions. Moving the mouse cursor to the word
        PgUp at the bottom of the screen and pressing the left
        mouse button (known as "clicking on it") has the same
        effect as pressing the <PgUp> key. Clicking on PgUp with
        the left mouse button has the same effect as <Ctrl-PgUp>.
        Clicking on PgDn at the bottom of the screen with the left
        mouse button has the same effect as pressing <PgDn>.
        Clicking on it with the right mouse button has the same
        effect as <Ctrl-PgDn>. Clicking on Home or End at the
        bottom of the screen with either mouse button has the same
        effect as pressing the <Home> or <End> buttons.
           Clicking on a link word with the left mouse button
        causes HyperRead to jump to the information referenced by
        that link word, just as pressing the <J> key does. Pressing
        the right mouse button causes HyperRead to backtrack
        through the links just like pressing the <B> key does,
        regardless of where the mouse cursor is located.
           Other functions, such as Load, Quit, and Search, cannot
        be controlled using the mouse. In some cases this is to
        prevent you from accidentally activating the function (like
        Quit) with the mouse. In other cases it is because the
        function requires keyboard input anyway, such as the word
        to search for.

                    Using HyperRead Generator

        Creating the text document

           HyperRead Generator creates the HyperRead control file
        that allows HyperRead to read a HyperRead file. First,
        you must create the document you want to convert to
        hypertext on your own word processor or text editor. Almost
        any word processor will do, provided it can create and save
        a file with the following characteristics:

        1) The file must be saved in plain ASCII.
        2) There must be a carriage return at the end of each line
        3) Each line of the file must be less than 80 characters
        long.
        4) The document may contain page feed characters (ASCII
        character 12) to force page feeds. However, it must not
        contain tab characters (ASCII character 9). Convert any
        such characters in your document to a series of spaces.
        5) The lines of the document may not contain any embedded
        line feeds other than those that accompany carriage returns.
        6) The document may not contain any nonprinting characters,
        such as bells or Esc characters. It may contain printable
        ASCII characters, such as graphic characters (ASCII 129 and
        above).
        What all this really amounts to is that the document must
        be pure ASCII. If your document does not satisfy these
        requirements, HyperRead Generator will offer to convert it
        to an acceptable format for you.
           Starting with version 5.5 of HyperRead, you can divide
        your ASCII document into sections of text. To separate
        sections of text from each other, simple put the line 
        ***END TEXT SECTION***
        on a separate line at the end of a section of text. This
        line must have the three asterisks, followed by the words
        END TEXT SECTION in all capitals, and the three more asterisks
        on the line exactly as shown, except that it must be the first
        thing on the line, with no spaces before it. There must be
        nothing else on the line, and no space before or after the
        string of asterisks. Although the HyperRead Generator will
        be able to move through the document freely with PgUp, PgDN,
        and other normal movement keys, the HyperRead Reader will not
        be able to move between sections except by using the Jump
        and Backtrack functions. This system is ideal for
        creating small footnotes, word definitions, short
        explanations, and so on. At the end of the main body of your
        text, you will be able to put a series of short sections and
        link the main body of the text to these sections by hypertext
        links. The reader can then read the main text, jump to the
        clearly defined short sections, and return to the main text
        using the backtrack key. They will not be able to 
        accidentally scroll out of the area of the small link that you
        intended for them to read. A typical document would be
        formatted like this:

        Main body of text
        ***END TEXT SECTION***
        First short footnote, definition, etc.
        ***END TEXT SECTION***
        Second short footnote, definition, etc.
        ***END TEXT SECTION***
        Second short footnote, definition, etc.
        ***END TEXT SECTION***
        .
        .
        and so on. The final ***END TEXT SECTION*** after the last
        block of text is optional, since the end of the text serves
        as an automatic block.
           If you divide your document into blocks of text like this,
        the normal procedure is to create links from words or phrases
        in the main body of the text to the first line of each short
        section of text. (DO NOT create a link to the line that reads
        ***END TEXT SECTION***.) This will allow the reader to jump
        from the word or phrase in the main body, read the short
        section, and then return to the main body. You can create
        jumps from within one short section to another or even back to
        the main body of the text if you want, but this will tend to
        get complicated and defeat the purpose of dividing the text
        up. The details of how to create jump links will be explained
        shortly in the section that explains the Mark command.
           Of course, this dividing of text into sections is entirely
        optional. You can have just one block of text that the reader
        can access through all scrolling techiniques and not include
        the ***END TEXT SECTION*** marker at all in your document.

       Loading a file into HyperRead Generator

           When you run HyperRead Generator (HRG5.EXE) or select the
        Load option, HyperRead Generator will give you three choices:
        You can load a new text file, load an existing HyperRead 
        document, or load an encoded text file. 
           A new file would be an ASCII document that you have not 
        yet created a HyperRead control file for. If you press 1, 
        HyperRead Generator will display a directory of all documents 
        in the correct directory and ask you which one to load. Type 
        the full name and press ENTER. HyperRead Generator will then 
        load the file.
           If the file does not satisfy the requirements for a
        HyperRead text file (for example, it contains lines that are
        too long or has control characters), HyperRead Generator will
        inform you of this and ask if you want it to convert the 
        file. If you press Y, HyperRead Generator will save your 
        original file with a BAK extension and convert the file. It
        will then load the converted file. During the conversion,
        HyperRead Generator will allow you set the left and right 
        margins (expressed as a number of spaces for the document and 
        choose how many spaces to replace a tab character with. The 
        default is no margins and 3 spaces for tab characters.
           The second type of file you can load into HyperRead 
        Generator is an existing HyperRead file. This means a document
        which you have already worked on and have a HyperRead control
        file (the file with an HRF extension). If you press 3 when the 
        program asks you what type of file to load, HyperRead 
        Generator will display a list of HyperRead control files. Type 
        the name of the file you want to load and press ENTER. You can 
        then add new links to the old document.
           The third type of file you can load into HyperRead 
        Generator is an encoded text file. This is a file that 
        HyperRead Generator will create at the same time as it creates 
        the control file if you press Y when it asks if you want to
        create an encoded text file. This is special file designed to 
        allow you to edit the text of your document after you have 
        created hypertext links in your text file. This will be 
        explained later in this manual.

        Creating links with HyperRead Generator

           Once you have loaded a file, HyperRead Generator
        operates very much like the HyperRead program. You load
        and view files the same way as with HyperRead. HyperRead
        Generator simply has several additional options that allow
        you to create the link words and save the new document to
        disk. The Print and Help HyperRead options are omitted
        from HyperRead Generator. You do not need these options
        with HyperRead Generator, anyway. You do no need the Help
        option, since you can print out the manual using
        HyperRead. You also can use your copy of HyperRead to
        print the file, if you want to see how it looks printed out
        by HyperRead.
           The additional options for HyperRead Generator are Mark,
        Unmark, and Disk. These options are explained below.

        Mark

           This is the option to create the HyperRead links that
        allow the reader to jump from one part of the document to
        another. You can create up to 2000 links in each document.
        If you try to create more, the computer will just beep at
        you.
           To create a link, move the document with the <PgUp> and
        <PgDn> keys so the word or phrase you want to turn into a
        link phrase is on the screen. Then use the cursor keys to
        move the screen cursor to the beginning of the word or
        phrase. Press the <M> key. Use the right cursor key to move
        the cursor to the end of the desired link word or phrase.
        You will notice that the word becomes blue (or reverse
        video with a monochrome display) as you move the cursor.
        You can use the left cursor key to backtrack if you go too
        far.
           When you have marked the entire link word or phrase,
        press the ENTER key. That ends the marking. Now move the
        document to the part of the document that you want the link
        word to point to (called the destination page). You can use
        all the normal movement techniques, such as PgUp, PgDn,
        Home, and End, to move within the document. You can even
        use the Search or Jump options.
           When you have found the beginning of the destination
        page, move the screen cursor (with the cursor keys) to the
        desired first line of the destination page. That is, the
        line that you want to be at the top of the screen when the
        user selects the link word. With the cursor on that line,
        press the <M> key again. The link is now established. The
        computer will then go back to the page with the link word.
           You can abort the marking process at any time until you
        have marked the destination page. Just press the <Esc> key
        to abort marking.
           The entire link word or phrase must be on one line. That
        is, once you have marked the beginning of the link phrase
        with the <M> key, you cannot move to the next line. Suppose
        you want to mark a phrase that is split at the end of a
        line. To do this, first mark the phrase up to the end of
        the first line. Hit the ENTER key, go to the destination
        page, and mark it with the <M> key just as you normally
        would. Then go back to the link phrase, mark the rest of
        the phrase starting at the beginning of the second line.
        Point this link phrase at the same destination page. What
        you are actually doing is creating two link phrases that
        point at the same page. It will act, however, as if the
        link phrase extended over several lines.
           If you want to create a link to a PCX file so that
        jumping from that link displays the file, simply include
        the name of the file in your ASCII document. Then mark the
        entire file name including the .PCX extension. After you have
        marked the word and pressed ENTER, simply press M to link
        the word to itself. If the link word ends in ".PCX", HyperRead
        automatically assumes that it is a PCX file and tries to load 
        it. For example, the file name SATURN.PCX has been included 
        in this document and linked. Clicking on it with the left 
        mouse button or pressing the <J> key while the screen cursor 
        is on it will display the picture. If the program cannot find 
        this PCX file, it will display an error message.
           If you want to create a link to an EXE, COM, or batch file 
        so HyperRead will run that program, simply put the name of the 
        program in your ASCII text document. You must include the 
        ".EXE", ".COM", or ".BAT" extension in the name. You may 
        include command-line parameters. Mark the full name of the file 
        (including command-line parameters) and link the word to 
        itself. For example, NOTHING.COM has been marked in this 
        document. If HyperRead cannot find the file when you try to 
        jump to it, HyperRead will return to its original state with 
        no error message.

        Unmark

           This function allows you to remove a link. Use the
        keyboard cursor keys to move the screen cursor to the link
        phrase you want to remove. Then press the <U> key. The
        phrase will no longer be a link phrase.

        Disk

           Pressing the <D> key causes the program to save the
        HyperRead control file on disk. If this is the first time
        you have saved this file, HyperRead Generator saves the
        file with the same name as the original ASCII text file,
        but with the HRF extension replacing whatever extension
        your ASCII file had. If you loaded a document that already
        had a control file, HyperRead Generator will use the same
        name the control file had when you loaded it. You should
        always save the control file before ending the program if
        you have made any changes in it (marked or unmarked any
        link words).
           After saving the HRF file, HyperRead Generator will ask
        if you also want to save an encoded text file. You would
        save this file only if you want to be able to edit the text
        file later without destroying the hypertext links. This will
        be explained later. Normally, you would press the <N> key to
        indicate that you do not want to save this file. If you do
        want to save this file, press the <Y> key.
           HyperRead Generator does not modify the original ASCII
        document file in any way. Only the control file (and
        optionally the encoded text file) is changed or created.

        PCX graphics

           HyperRead and HyperRead Generator display PCX files in
        three basic formats:

        1) 256 color PCX files. These are always displayed on a
        320 X 200 pixel screen (screen mode 13).
        2) PCX pictures of 16 colors or less having a height of
        350 pixels or less. These are displayed on a 640 X 350
        pixel screen (screen mode 9).
        3) PCX pictures of 16 colors or less having a height of
        more than 350 pixels. These are displayed on a 640 X 350
        pixel screen (screen mode 12).

           Pictures that have more than 256 colors or are wider than
        the screen they are displayed on (320 for 256 color pictures
        or 640 for pictures with 16 or fewer colors) will appear as
        hash on the screen. Pictures of 16 colors or less that are
        taller than the display screen will be cut off at the bottom.
        Pictures of 256 colors that are too tall will display the top
        part of the picture, then overwrite this with the bottom part.
        It is the responsibility of the person using HyperRead
        Generator to test all pictures to be displayed by HyperRead to
        make sure that they are in a format that works properly with
        HyperRead.
           Pictures that are narrower or shorter than the display
        screen will simply not fill up the screen. For example, a 16
        color 320 by 200 picture will appear in the upper left corner
        of the screen. Pictures with less than 16 colors will be
        displayed using whatever colors they have. Note: There are
        several file formats for PCX pictures, and you may
        occasionally get strange results from some of the less
        common ones. The most common problem is that some PCX formats
        do not contain color information. Such pictures may appear in
        random colors, rather than the correct colors, when viewed
        on HyperRead. This is most common with old black-and-white
        PCX pictures. The picture will be visible, but the black and
        white colors will be replaced by some random colors, like
        red and purple.
           In order to make it easier to create pictures for
        HyperRead, there is a special PCX file called BLANK.PCX
        provided with HyperRead Generator. This is a 16 color,
        640 X 350 PCX picture of absolutely nothing. You can load
        this PCX file into your paint program. This will automatically
        configure the paint program to the proper settings for 16
        color, 640 X 350 PCX files. You can then draw on the blank
        screen. When you are finished, save the picture using
        the Save As option and give the picture a different name.
        If you do not change the name, you will overwrite the
        BLANK.PCX file, making it harder to create pictures in the
        future.
           Note: Some paint programs, including Windows Paint,
        create pictures that are slightly distorted (thinner) when
        viewed by HyperRead. To compensate for this, you might
        want to draw the pictures a little thicker horizontally
        than you want them to appear on the screen. The pictures
        will then look correct when displayed by HyperRead. You
        might want to create a few sample pictures of circles and
        squares and load these into HyperRead to check this out
        before you create any elaborate pictures with your paint
        program.

        Modifying HyperRead documents

           Once you have created a HyperRead control file for a
        document, you should not change the ASCII text file. Doing
        so can mess up your link pointers or cause other
        undesirable results. In particular, any change that
        decreases the total number of lines in the file will cause
        HyperRead to crash when trying to load the file. If you
        add lines, the new lines will not be read in when you load
        the document into HyperRead. If you add lines in the
        middle of a document, all links after the added lines will
        be in the wrong places. Adding text in a line will cause
        all links on that line after the added text to be wrong.
           To make changes in the text of a document after you have
        created links in the document, load your existing HyperRead
        file into HyperRead Generator. Once the file is displayed on
        the screen. Press the <D> key. When the program asks you if
        you want to save an encoded text file also, press the <Y>
        key. Then exit HyperRead Generator by pressing the <Q> key.
           The encoded text file has the same name as your text file, 
        but has the ETF extension. You can load this file into most
        text editors. Simple text editors, such as the EDIT function
        that comes with DOS 5.0 and above, generally work best. Some
        fancier text editors may be confused by the control codes 
        that HyperRead Generator embeds in the text.
            The encoded text file will look much like your original
        text file, except you will see some odd looking control
        characters, like faces, houses, and foreign letters. When 
        editing the encoded text file in your text editor you must
        obey a few simple rules:
        1) Throughout the file you will see many smiling faces of
        various colors. Each face is followed by two other odd
        looking characters, usually foreign letters or graphic 
        characters. Do not delete or edit this string of three 
        characters. You will also see some characters that look like 
        little houses. Do not delete these either. Deleting the 
        faces, the two characters after them, or the houses will 
        destroy hypertext links. If you delete entire lines 
        containing the characters, the links will automatically be 
        deleted by HyperRead Generator.
        Note: The faces and houses may look like boxes if you are
        viewing the file in a Windows program, such as Windows Write.
        The foreign characters may look different, too.
        2) In editing the file, you should not create lines that are
        too long (over 79 characters, not counting the faces or 
        houses) for HyperRead generator. The same rules apply to this 
        file as the original text files.
           Once you have modified the encoded text file with your text
        editor, save it as an ASCII text file. You may then run
        HyperRead Generator and load the encoded text file (select 3
        in the menu that lists types of files to load). When HyperRead
        Generator loads the file, it will translate the code 
        characters into HyperRead links and save a new control file
        with an HRF extension. It will also create a new version of
        the original text file that contains the text changes you made
        in the encoded text file. Since this overwrites both the text
        file and the control file, you might want to save these in
        another directory just in case you want to go back to the
        original file.
           HyperRead Generator has considerable power to decipher the
        changes you make in the encoded text file and create a new 
        ASCII text file and HyperRead control file. On rare 
        occassions, you may have changed the text file in such as way
        that HyperRead Generator is unable to accept the new file. For
        example, you may have created lines that are too long (over 79 
        characters) or erased parts of links without erasing the whole
        link. If this happens, HyperRead Generator will display an 
        error message and terminate the program run, returning you to
        DOS. The original ASCII text file and control file will not 
        be altered. You may then go back to the encode text file and 
        repair it. If some lines are too long, shorten them. It there 
        are partially deleted links, erase the remaining link fragment
        (usually one of the house characters) in the line indicated 
        when HyperRead Generator terminated and try to load the ETF
        again.
            Once HyperRead Generator has loaded the encoded file, it
        will display the file as it normally does. You can then add
        or remove links from the file and save it, just as if you
        had loaded the file from a control file (selection 3 in the
        menu that lists types of files to load).

        Mouse support

           HyperRead Generator uses the mouse the same way as
        HyperRead.

        System Requirements

           Both HyperRead and HyperRead Generator should run on
        any IBM compatible computer with at least 256 K of memory.
        The text portion of the document  will display on any
        display system, even an old MDA card with a monochrome
        display. To display the PCX files, you must have an EGA or
        better graphic card. The Print option will work with any
        type of printer, even a daisy-wheel.

        Distributing HyperRead Documents

          To distribute a HyperRead Document, you need to include
        in the package the following items:

        1) Your original ASCII text file.
        2) The HyperRead control file for that document with the
        HRF extension.
        3) The HyperRead program. This is a freeware program, so
        you can distribute unlimited copies. It is suggested but
        not required that you include the READER.DOC and READER.HRF
        files with the program itself so the user can fully
        understand the features of the reader. Otherwise, your
        document itself should include reasonable instructions on
        how to use HyperRead. At the very least, mention that the 
        reader can get some instructions by pressing the <H> key.
        4) Any PCX, COM, EXE, or BAT files that you have linked
        with your document.

          Do not distribute the file with the ETF extension created
        by HyperRead Generator. That is for your use only.

        Uses for HyperRead

           You can use this program to create any type of
        easy-to-read document you like. For example, you can create
        a HyperRead instruction manual. The users can quickly zero
        in on any problems they have by using link words to go to
        more and more specific descriptions of the problem. This
        document is an example of such a file. Instruction manuals
        for shareware programs are a particularly good use for
        HyperRead.
           HyperRead reference "books" can also be easy to use.
        Consider a HyperRead cookbook. The first few pages of the
        HyperRead file could be a list of recipes. The name of each
        recipe could be a link word or phrase. The user could jump
        directly to the recipe by pointing to it with the cursor
        and pressing the <J> key. Within the recipes, some of the
        more unusual ingredients could be link words. These links
        could take the reader to a section at the end of the "book"
        that gives information on the ingredients.
           In a similar fashion, you could make each item in a
        table of contents of any file a link phrase. The reader can
        then jump directly to that page using the link phrase.
           A more entertaining use of the HyperRead function is
        interactive fiction. This is an increasingly popular form
        of literature. In such a book, the reader does not read the
        book from start to finish. Instead, the book offers the
        reader choices on what to read. A typical story might say
        something like, "If you want to explore the cave, turn to
        page 38. If you want to continue on the path, go to the
        next page." With HyperRead, you could have the reader
        select which action to take by selecting the proper link
        phrase. The program would then take the reader to the
        proper page. This is similar to text adventure games.

        Registering HyperRead Generator

           HyperRead Generator is shareware. You are free to
        experiment with it and create test documents for as long as
        you like. However, before you may distribute any HyperRead
        documents you create with HyperRead Generator, you are
        required to register it by sending $25.00 to:

                      Leithauser Research
                      4649 Van Kleeck Drive
                      New Smyrna Beach, FL 32169

           This is a one-time fee. Once you have registered
        HyperRead Generator, you may use it on one computer to
        create as many HyperRead documents as you like without
        paying any additional fees.

        Registering HyperRead Generator gives you several benefits:

        1) You can legally distribute documents created with
           HyperRead Generator.
        2) You will receive the latest version of HyperRead
           Generator when you register.
        3) You will automatically receive fixed versions of
           HyperRead and HyperRead Generator if any bugs are
           discovered.
        4) You will receive announcements of major upgrades and
           have the opportunity to receive these upgrades for
           just $5 S&H.

        Bug reports, suggestions, questions, etc.

           If you have any questions about HyperRead or are
        encountering any problems, you can write to Leithauser
        Research at the above postal address. You can also reach
        Leithauser Research at any of these EMAIL addresses:

        America Online: Leithauser
            Compuserve:  74046,1556
                 GEnie:  D.LEITHAUSER
              Internet:  74046.1556@compuserve.com

           In extreme emergency, you can call (904)-423-0705
        between the hours of 11 AM and 10 PM Eastern time.

        Custom software

           The primary function of Leithauser Research is
        developing custom software to customer specifications. If
        you need a program you cannot find anywhere, or you have an
        idea for a program that you want to sell but do not have the
        programming skilled to write the program yourself, contact
        Leithauser Research at any of the above addresses (postal or
        EMAIL) with a description of the program you have in mind
        for a price quote. Prices are extremely reasonable. Unusual
        and artificial intelligence programs are our speciality.
***END TEXT SECTION***
           This is an example of a separate section of text that can
        only be accessed by the Jump function of the HyperRead Reader.
        Because these sections are intended to be small (and to reduce
        the size of the HyperRead program), the Search and End options
        are not implemented in text sections after the first section,
        which is assumed to be the main body of text. However, scroll
        up and down with the cursor keys, PgUp, PgDn, and Home
        functions will work within these small sections of text if
        they contain more than one screen of text.
