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 and keys. You can move one line at a time by holding down the Ctrl key as you press or . 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 key on your keyboard, or go to the end of the document by pressing the 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 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 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 (HR) 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 (HR) 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 HR 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 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 key while pressing the key, however, the screen will scroll only one line. PgUp Pressing the key scrolls the text up 23 lines. If you hold down the key while pressing this key, however, the text will scroll only one line. Home Pressing the 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 . End Pressing the key moves you to the last page of the document. If you want to get to a page near the end, you can press and then a few times. This is sometimes faster than pressing 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 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 and 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 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. In addition to displaying a picture or running an executable file with a link, you an load another HyperRead file. Although only one HyperRead file can actually be in memory at a time, HyperRead can jump back and forth between files easily, allowing you to treat a group of HyperRead files as one. This can considerably simplify the editing process. To link to another HyperRead file, make the link phrase the name of the HyperRead control file. This is the file with the HRF extension. For example, clicking on the link READER.HRF will load the HyperRead Reader instruction manual. Once in this manual, you can jump around like in any HyperRead document. You can backtrack through the jumps you made while in the second document normally. When you select to backtrack after you have backtracked through any jumps you made while in the second file, you will be brought back to the first document. This process can be carried through any number of documents. For example, suppose you jump from document A to document B, jump around in B for a while and from within B jump to document C. You then jump around in C a while and then start backing out. Once you have backtracked through any jumps you made in C, your next backtrack will bring you to document B. Once you backtrack through any jumps originally you made while you were in B, your next backtrack will take you back to document A. The most common use for this technique would be to break a large document into smaller ones (or simply not combine the chapters in the first place). You could, for example, have a book with many chapters. You could create a HyperRead file for each chapter containing any links within the chapter. After you had finished all the chapters, you can create a document that contains just a table of contents for the book. You could then link each chapter listing in the table of contents with the HRF file for that chapter. The reader could select a chapter to read. When they had finished the chapter, they could backtrack to the table of contents and jump to another chapter. If you do not want to have the link phrase be a name of a file such as SATURN.PCX or NOTHING.COM or READER.HRF, there is another way to cause the link to show a PCX file or run a program or load a HyperRead file. If the link goes to a line that contains nothing but a file name, HyperRead will display that picture file or execute that file, then return to the line that contained the link to that line. You would normally put the line containing the file name in a separate section of text (as explained above) so the person reading your document does not find the line and wonder what a file name is doing on a line all by itself. As a demonstration of this technique, jump to demo picture now to see the picture of Saturn or Nothing program to run the nothing program or Reader manual to jump to the HyperRead Reader manual. Note that this technique works only in the HyperRead reader program, not the Generator program. This is done deliberately to allow you to jump to the protected area of text containing the file names while developing the document using the HyperRead Generator without triggering the display or execution of the file. Backtrack This function allows you to reverse the effects of the Jump function. When you press the 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 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 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

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 key. Clicking on PgUp with the left mouse button has the same effect as . Clicking on PgDn at the bottom of the screen with the left mouse button has the same effect as pressing . Clicking on it with the right mouse button has the same effect as . Clicking on Home or End at the bottom of the screen with either mouse button has the same effect as pressing the or 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 key does. Pressing the right mouse button causes HyperRead to backtrack through the links just like pressing the 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 (HRG.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 and 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 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 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 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 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 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 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 key. The phrase will no longer be a link phrase. Disk Pressing the 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 key to indicate that you do not want to save this file. If you do want to save this file, press the 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 key. When the program asks you if you want to save an encoded text file also, press the key. Then exit HyperRead Generator by pressing the 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 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 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 Internet: Leithauser@aol.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. ***END TEXT SECTION*** SATURN.PCX NOTHING.COM READER.HRF