This is the documentation file for Doug's General Text Processor (or 
GTP).  The GTP is an IZL program that takes a text file you specify, 
does "stuff" to it, and writes it out to another text file that you 
specify.

When you start it up, you'll see a number of buttons.  The first two 
deal with what files you're going to use:

Input -- This pulls up a file selector to let you pick the input file.  
You can double-click on the file you want, or you can single-click on 
it and then click on OK.

Output -- This lets you name your output file.  Use the file selector 
to get to the directory you want your output to go, type in the file 
name, click on OK.  Be careful, though, because the GTP will 
completely replace any existing file that has the same name as your 
output file.

The next several buttons are all labeled "Toggle".  They let you pick 
what you want the GTP to do to your input file.  The different options 
you can pick are:

Case -- You can have the GTP convert all your input text to upper case 
(LIKE THIS), lower case (like this), or proper case (Like This), or 
you can have it leave the text the way it found it.

Replace -- Selecting this option tells the GTP to replace what's in 
the first text box with what's in the second text box.  Two points of 
interest:  First, whatever you want to replace must be contained in a 
single line of text, not across several lines.  Second, if you're 
fiddling with the case of your input text (see above) then the replace 
automatically becomes case-insensitive.  (Eg, "Mary" is the same as 
"MARY" is the same as "mARy".)  If you're *not* changing the case of 
the input file, then the replace is case-sensitive.  (Eg, "Mary" does 
not match either "MARY" or "mARy".)

Include -- You can use this to tell the GTP to output only those lines 
which contain a certain text string (the one you type in the box, of 
course), or you can tell it to output only those lines which do *not* 
contain the text string.  Of course, you can also tell it just to 
include everything.

Spaces -- This option lets you have the GTP delete leading spaces (at 
the beginning of the line), trailing spaces (at the end of the line) 
or both from the output file.

Once you've selected your files and toggled through the options you 
want, you click on the "Process Text" button, and away she goes!  The 
GTP blanks out the input and output file names when it's done 
processing.  If you want them back, just click on the Input or Output 
button (whichever one you want to get back) and then click on OK.

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.
