
This archive file contains the BeOS 5 executable program 'arun' (renamed
to 'HM' so that it automatically loads the Hollywood Murders game
files.) The following text is the 'readme' file that came with the BeOS
port of the arun program.


	================================================
	ARUN - Alan Runtime Interpreter - Version 2.8.6
	================================================
	      Copyright 1999 Thomas Nilsson
	       thomas.nilsson@progindus.se

	   BeOS Version (Release 1, October 2000)
	      Enquiries about this BeOS port to
	       stephen.griffiths@xtra.co.nz


============
Introduction
============
Arun is a BeOS "Terminal" command-line application for playing text
adventure games written with the ALAN Adventure Language.

The ALAN Adventure Language is a text game programming system 
created by Thomas Nilsson.  This version of Arun can play ALAN games 
written with either version 2.7 or 2.8 of the ALAN compiler.

See the ALAN Home Pages at http://welcome.to/alan-if for information
about ALAN games and the ALAN programming language. (Note that, at
the time of writing, there is no port of the ALAN compiler to BeOS.
However the compiler is available for many other OS's including
MSDOS/Windows, Macintosh and Linux.)


=======
Licence
=======
Arun for BeOS is released as 'freeware' - meaning that the author,
Thomas Nilsson, retains copyright on the software but is licensing
whomever might wish to use the software to download and use the software
at no charge. 


=========
Resources
=========
ALAN Home Pages at http://welcome.to/alan-if for information and
software.

Alan games can be downloaded from the Interactive Fiction Archive at
http://ifarchive.org/

Usenet discussion groups about text adventure games
  rec.games.int-fiction  (playing text games)
  rec.arts.int-fiction   (writing text games)


============
Instructions
============
Alan games come in two component files - one with an extension of .acd
and another with an extension of .dat.

To play an Alan game ... 

  - start a Terminal session 

  - change current directory to the directory containing the game's .acd 
and .dat files 

  - start Arun by typing arun followed by the name of the Alan game
without the filename extensions. 
(Note, that if Arun isn't in the same directory as the game-files you 
will need to specify the path to the Arun program.)

For example, a game called "Dragons" might be contained in a pair of
files called dragons.acd and dragons.dat which you've stored in a
directory called games. And the arun executable is in a directory called
alan. To play "Dragons" start a Terminal session and enter the following
commands

	cd games
	/alan/arun dragons

The command to exit from a text adventure game is usually "quit". 


========
Feedback
========
Please send any comments or bug reports on this BeOS port of Arun to
stephen.griffiths@xtra.co.nz

Thank you.

Stephen Griffiths
October 2000.
