README for Language::Basic 

Language::Basic is a Perl module implementation of the BASIC computer language
It allows you to run BASIC programs or translate them to Perl scripts.
Note that it implements 80's-era BASIC. Think Applesoft or GW-BASIC.

WARNING: don't let the RCS version number fool you. This is an ALPHA RELEASE.

--------------------------------------------------------------------------------
Mini-FAQ:

Q. How do I install it?
A1. tar zvxf Language::Basic-*.*.gz
    perl Makefile.PL; make
    Optionally, "make test" and "make install"
A2. See the INSTALL file for more details

Q. What's new?
A. See (the top of) the CHANGES file

Q. What exciting changes are planned for the future?
A1. More BASIC functionality, better error checking and documentation,
    and the evil secret project, Ye Eldritch Triangle of Interpretation
A2. See the TODO file

--------------------------------------------------------------------------------
Included Stuff:

Perl scripts (in scripts/ directory until you make install):
- basic.pl runs BASIC programs from the command line 
- termbasic.pl is a Term::Readline application that lets you write code
  one line at a time and then run it.
- basic2pl.pl translates BASIC programs into Perl. (It's not
   pretty, but it's not as bad as you might think, either.)

Documentation is included as POD in the .pm files. There's also a
description of the currently supported BASIC syntax in the 
Language::Basic::Syntax pod page. Documentation will be turned into man
pages by make, and installed by make install.

Gregory Yob's classic BASIC adventure game, Hunt the Wumpus, is included for
your playing pleasure. (The game was apparently written before they invented
software licenses. I hope he doesn't mind my distributing it.) Translating it
to Perl, and comparing it with the Perl Power Tools wump(6) port, are exercises
left to the reader.

--------------------------------------------------------------------------------

I welcome comments, criticisms, bug reports, bug fixes, and ideas.  (But please
check the BUGS section of the Language::Basic man page before sending in bug
reports.) Actual patches are even more welcome. Also, feel free to send along
any fun/interesting BASIC programs you have lying around.

Enjoy!

-Amir Karger
akarger@cpan.org