			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
	alan		- executable Alan compiler (may have different name!)
	arun		- executable interpreter (d:o)
	alan.prod	- Alan Language grammar in compact form

	jungle.alan	- source for the jungle example
	jungle.acd
	jungle.dat

	dungeon.alan	- source for the Dungeon prelude
	dungeon.acd
	dungeon.dat

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

	arun jungle

or

	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 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 complete free. See COPYING for details.

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

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

and its mirrors.


Thanks for your interest and have much fun!

	The ThoNi & GorFo Adventure Factories
