This is the documentation file for READTEXT, an IZL 2.0-based program 
that lets you read text files of any length.  The zip file you 
received should have contained the following files:

READTEXT.IZL -- The IZL 2.0 source code
READTEXT.DOC -- This file
READTXTD.IZT -- The tokenized program, desktop version (80 chars/line, 
                15 lines/page)

In addition, READTEXT creates a bookmark file, READTEXT.DAT, when you 
first run it.

The reason READTEXT can handle text files of any size is because it 
doesn't attempt to load the entire file into memory.  Instead, it 
loads a single page of text and displays it for you.  You navigate 
through the text file by using the various buttons on the screen.  
Here are brief descriptions of the buttons:

New File -- When you click on this button, READTEXT presents you with 
directory of files.  You can select a file to read by double-clicking 
on the file name or by selecting the file and clicking on "OK".  If 
you don't want to select a file, click on "Cancel".

Save Mark -- This button lets you set a bookmark in the file you're 
currently reading, in case you want to come back to it later.  
READTEXT lets you have only one bookmark, which is saved in the file 
READTEXT.DAT.  If you select a new file (see the New File button), 
then READTEXT automatically sets the bookmark to be at the top of the 
new file.  Whenever you start up READTEXT, it takes you immediately to 
your last saved bookmark.

Go To Mark -- Clicking on this button takes you back to the last 
bookmark you saved. (see the Save Mark button)

Top -- This button takes you back to the beginning of the file you're 
currently reading.

Prev -- When you click on the Prev button, READTEXT normally takes you 
back to the previous page of text.  However, if you just did a Find 
(see the Find button below), then Prev takes you back to where you 
were before you did the Find.  You can go back up to one hundred pages 
using Prev.

Next -- This button takes you to the next page of text.

Find -- If you type some text into the text box provided and then 
click on Find, READTEXT will attempt to find it for you.  It starts at 
your current position in the file and does a line-by-line, 
case-sensitive search.  If the search is successful, READTEXT displays 
a page of text starting with the line containing the text.  Please 
note that if you click on Prev (see the Prev button) after a 
successful search, READTEXT takes you back to where you were before 
you did the search.  Also note that the search mechanism is not very 
fast, especially if you have a large file.

DEVELOPER'S VERSION
-------------------
If you have the developer's version of IZL 2.0, you can change the 
appearance and behavior of READTEXT by changing some of the variables 
in the source code:

MaxChars -- controls the maximum number of characters displayed per 
line.  If READTEXT reads a line of text that's longer than MaxChars, 
it word-wraps it onto the next line of the screen.

NoOfLines -- determines how many lines are shown per page.

MaxPages -- sets how many pages you can go back using Prev.  The 
default is 100 pages.

This program was written by Doug Taylor (doug-taylor+@osu.edu).  It has
been placed into the public domain.  Feel free to hack it, steal
routines from it, or whatever.
