ALAN - README


This archive contains the compiler package of the Alan System.

Alan is a special purpose computer language for creating text
adventures, also known as interactive fiction.

The archive contains the following files

	README		- this file
	COPYING		- complete copying conditions
	CHANGES		- history of changes
	GRAMMAR		- Alan Language grammar in compact form
	alan		- executable Alan compiler (may have different name!)
	arun		- executable interpreter (d:o)
	jungle.alan	- source for the jungle example
	dungeon.alan	- source for the Dungeon prelude

To run the examples unpack the archive and issue the following commands

	alan jungle
	arun jungle

or

	alan dungeon
	arun dungeon

If this archive is distributed through e-mail it is possibly encoded
and split into small pieces. Local wisdom should be available at your
site on how to unpack the archive. Below are a few examples on common
packaging and commands to extract the files.

	File name		Command
	-----------------	-----------------
	alanXXXsun.tar		tar xvf alanXXXsun.tar
	alanXXXamiga.lzh	lharc x alanXXXamiga.lzh


If you can't seem to find anyone to show you how to unpack the
archives contact The Factories at:

	thoni@softlab.se
	gorfo@ida.liu.se


NOTE1: To use the compiler regularily you are required to
register. Registration is free and can be done with a simple email:

	To: alan-request@softlab.se
	Subject:Registration
	From: <your e-mail address goes here>

	REGISTER


NOTE2: Re-distribution of the interpreter together with games produced using
the Alan system is allowed and completely free. See COPYING for details.


NOTE3: Distribution and documentation packages are available through
e-mail or by ftp at

	ftp://ftp.gmd.de/if-archive/programming/alan

and its mirrors.


NOTE4: The Alan home pages are at

	http://www.pp.softlab.se/thomas.nilsson/alan


Thanks for your interest and have much fun!

	The ThoNi & GorFo Adventure Factories