======================================================================
		    Test File for rot13 version 1.3
======================================================================

----------------------------------------------------------------------
		   Part Zero - Instructions and Info
----------------------------------------------------------------------
Here is a simplified format of the rot13 command line:

	rot13 [[options] <filename>]

For succinct help, just use the -h option.
For in-depth information, see the man page.

----------------------------------------------------------------------
		     Part One - Changes Since 1.2
----------------------------------------------------------------------
rot13 now accepts input from stdin thanks to changes by  Kevin
Turner (Acapnotic). Also there is no switch for this, it is the
default behavior if no filename is specified.

I/O Summary:
	stdin ---> stdout
	stdin ---> user-specified file
	file  ---> stdout
	file  ---> user-specified file

Quiet mode (old -q) is now the default behavior.
The new -q argument now causes statistics to print.

Output no longer defaults to the file OUTPUT.ROT when using
an input file.  The new default is stdout.

The -c, -u and -r options have been removed.  They were good
examples of creeping freaturism and code bloat.  -r didn't
provide any truly useful information;  -c and -u kind of defeat
the purpose of a rot13 program and I never was happy with the way
they worked internally anyway.

I did learn one thing from the -r option however. I had compiled 
rot13 under DOS as a test and decided to make it into a Borland
EasyWin program. I ripped out all the command line option code
while leaving the -r info in as a default.  Then I ran the DOS
version and the Windows version over the file SETUP.TXT which you
can find at C:\WINDOWS\SETUP.TXT.  The DOS version took 220 clock
ticks to execute and the Windows version took just over 16,400.
The lesson is: Windows is 75 times slower than DOS.

----------------------------------------------------------------------
		  Part Two - A Concise History of rot13
----------------------------------------------------------------------
Development of this program was caused by 2 things: the Red Dwarf
FAQ and the Hacker Jargon File.  The first had rot13 ciphered text
in it the the second had an explanation of it.

So instead of spending 10 minutes deciphering the text in the FAQ,
I spent a 6 hours writing a program that turns your very expensive
computer into a Decoder Ring out of a Happy Meal.

That first program accepted up to 99 characters from stdin and spat
them back out at you, rot13ed.

Then, I decided to learn how to do file physical file I/O in C.
So that's what version 1.0 did.  Version 1.1 basically added all
of the command line args except -c, -u and -r which were added in
1.2, the first publicly released version (other versions were
tested by myself and 2 friends).

This new version (the last I plan to release) exists because Kevin
Turner sent me a patch he had created that allowed for true stdin input.
This meant that rot13 could now accept piped input.

Kevin implemented this addition as a  command line arg but I 
think that he probably did this to keep from hurting my feelings :)
because a unix utility *should* accept input from stdin if no physical
file is specified for input.  So I have done this and also made the 
end-of-run stats print optionally; this means that rot13, without
having to use options or arguments at all, can piped into and out 
of cleanly (I think).

----------------------------------------------------------------------
			   Part Four - Test Data
----------------------------------------------------------------------
rot13 should only molest alphabetic data.  Here's something to check
it against:

   .-------------------------------------------------------.
   |ABCDEFGHIJKLMNOPQRSTUVWXYZ | NOPQRSTUVWXYZABCDEFGHIJKLM|
   |nopqrstuvwxyzabcdefghijklm | abcdefghijklmnopqrstuvwxyz|
   |---------------------------+---------------------------|
   |   `1234567890-=[]\;',./   |   ~!@#$%^&*()_+{}|:"<>?   |
   `-------------------------------------------------------' 
