
####################################
#   Installing APRON Software      #
#   ~~~~~~~~~~~~~~~~~~~~~~~~~      #
#              0.7.1               #
#                                  #
#    (c) David R W Barr 2009       #
# http://research.david-barr.co.uk #
####################################

This guide assumes you have Crimson Editor installed on your system.
Crimson Editor is a free advanced text editing tool that can function
as an IDE for many compilers. It is the preferred tool for using with
APRON as config files have been created for syntax highlighting and
tool integration, meaning you have a powerful text editing IDE with
built-in APRON simulation tools.

If you do not wish to use Crimson Editor, and instead prefer to use
some other tool, the steps here will guide you on how to configure
the APRON compiler to be run from the command line.


Download Crimson Editor here: http://www.crimsoneditor.com

NOTE! If installed in the program files folder in Vista, you may not have
the required permissions to perform customisation. Ensure your security
settings are appropriately set, or install to a different location.


###########################
# SYSTEM REQUIREMENTS !!! #
###########################

These are the recommended requirements:
	Intel Processors (Dual Core) > 2.0Ghz -or- Modern AMD Processors (Dual Core)
	(NOTE: Single cores will work acceptably well, dual is just better)
	1GB RAM
	50MB Hard Disk Space
	A Text Editor / IDE (See Crimson Editor above)
	32-bit Microsoft OS: 2000, 2003, XP, VISTA
	
	Visual C++ 2008 Runtimes
	http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf
	



###################
# UPGRADING !!!!! #
###################

Follow the same instructions for installing, just overwriting files as necessary.
The following files can be ignored: 'apron.cmd' and 'extension.aps'



##################
# INSTALLING !!! #
##################

1) Download and Install Crimson Editor http://www.crimsoneditor.com

2) Create a directory "C:\APRON". This is the preferred location, if you
must install elsewhere, then make sure you edit the Crimson Editor tool files
accordingly.

3) Copy 'apron.cmd' into '[Crimson Editor]\tools' folder

4) Copy 'apron.key' into '[Crimson Editor]\spec' folder

5) Copy 'apron.spec' into '[Crimson Editor]\spec' folder

6) Copy 'extension.aps' into '[Crimson Editor]\link' folder

7) Copy the APRON folder contents in the install bundle into 'C:\APRON'

8) Open Crimson Editor and Goto "Tools -> Conf. User Tools". Here you can see the 
tools 'APRON Build' and 'APRON Run' By selecting these tools, you can see if they
link to the correct APRON install location ('C:\APRON' by default). If you did not
install APRON here then change the location accordingly. If you make changes, ensure
you save them.

9) Install is (hopefully!) complete.

10) You can now use CTRL+1 to build the APRON simulation, and CTRL+2 to execute it.

11) It may be useful to associate ".aps" files with Crimson Editor ("cedt.exe"), and 
".apron" with 'ApronSim.exe'. Just double clicking on the files in explorer should
initiate this process, if they are not already assigned to an executable.




##################
# DISCLAIMER !!! #
##################

The developers of this software hold absolutely no responsibility for anything that 
may go wrong with anything. Assume this software is incomplete, has bugs, and is 
likely to go wrong. By using APRON software, you are agreeing to these terms.


