+----------------------------------------------------------------------
| Argh! - README
| $Id: README,v 1.2 2004/07/17 20:07:20 wilde Exp $
+----------------------------------------------------------------------

This is the official Argh! distribution.  It includes an interpreter
for Argh! and Aargh!, the official language specification, an Aargh!
editing mode for GNU Emacs and some examples of Argh!-code.

The "contrib" directory contains contributed examples and tools by
various authors.  


DOCUMENTATION
----------------------------------------------------------------------
For documentation of Argh! and Aargh! please read the official
language specification: "Argh-Spec.txt".


BUILDING
----------------------------------------------------------------------
To build the interpreters simply type make.  This will produce two
binaries: `argh' the Argh! interpreter and `aargh' the extended Argh!
(Aargh!) interpreter.  For instructions on installing the Emacs Argh!
mode please look at the comments in `argh-mode.el'.


USAGE
----------------------------------------------------------------------
Usage is simple, just call the interpreter with the filename of the
Argh!-program as first argument:

$ argh ./examples/hello.agh

If the interpreter gets called with no argument, it reads the
Argh!-program from stdin.

You can even put "#!/path/to/argh-interpreter" in the first line of
your code and make the Argh! program executable.  (At least on
systems, which understand #!-magic).



Happy hacking!

Sascha Wilde
<wilde@sha-bang.de>
