Kurt's Brainfuck Interpreter v0.1.1
Copyright (C) 2003
Released under the terms of the GNU General Public License, Version 2
See the file COPYING for details

WHAT'S NEW
This release fixes a bug in which the interpreter prompt returned an error
when a blank line was entered at the prompt or there was data left over in
standard input after running a program.  It didn't really hurt anything, but
it was annoying.

NOTES
This interpreter is very slow.  Right now, my concern was getting it to work.
Optimizations will come later.

INSTALLATION
To compile, simply type 'make'.  You can edit the source code and Makefile
as you wish.

USAGE
Usage is simple.  To start the interpreter, simply type "bfi" at the command
line.  Once you are there, you will be greeted with a simple message and a
prompt that looks like this: >
At this prompt, you type commands.  Each command performs a certain function,
as listed below:

exit
	Exits the interpreter.  Takes no arguments
file
	Loads a Brainfuck file to run.  If a file has already been loaded when
	this command is issued, it will be closed and the new file will be
	opened in its place.

	EXAMPLE: file hello will load a file named "hello.bf", or will return
	an error message if no such file can be found.
mode
	Lets you switch between one of two execution modes, as follows:

	anal: Anal mode treats whitespace as a syntax error, and will stop
	execution when whitespace is found.

	vaginal: Vaginal mode does not treat whitespace as a syntax error.
	Instead, the interpreter simply ignores any whitespace it finds.  This
	is useful if you don't like having your programs all on one big-ass
	line.

	EXAMPLE: mode anal will switch to anal mode (vaginal is the default)
run
	Runs the Brainfuck program.  It first checks to ensure that the opening
	and closing brackets are balanced.  If they are not, interpretation is
	terminated and an error is returned.  The program must have been
	previously loaded by the "file" command, and only one program can be
	loaded at a time.  If a syntax error is encountered, interpretation
	will stop, an error message will be displayed, and the program will
	return to the prompt.

Note that the Brainfuck interpreter gives no indication that a command has succeeded; only when an error has occurred is a message displayed.

Have fun!  Send comments, questions, flames, and hate mail to Kurt at 
kmw@rowsw.com

-- Kurt Weber
   September 28, 2003
