home

Installation (from INSTALL)

Angicart depends on OCaml and other open-source UNIX utilities, and is known to work on most Linux distributions and on OS X. OCaml is not currently supported on Windows. Lines beginning with are meant to be typed at the command-line (Terminal) without the

. If you need help, please contact the author as described in the README.

1. Obtain and install git. General instructions can be found at http://git-scm.com/download.
2. Install system dependencies using your OS package manager. On OS X, homebrew is a package manager for Unix software, available at http://brew.sh/. Once homebrew is working, Angicart's system dependencies can be installed as:

   	$ brew install pcre sdl sdl_image

3. Obtain and install OCaml and OCaml packages. Angicart is known to work with recent versions of OPAM. To install OPAM, see http://opam.ocaml.org/. The library dependancies of Angicart are provided by OPAM packages. Once OPAM and the system dependencies are installed, invoke:

   	$ opam install batteries pcre lablgl ocamlsdl ounit

4. Obtain Angicart and run it. The following command will create a directory called angicart in the current directory.

   	$ git clone https://github.com/mnewberry/angicart.git

   Enter that directory.

   	$ cd angicart

   Run the graphdisplay program to see if everything works.

   	$ ./make.sh graphdisplay run --help

   If you see the help screen (and not an error), then everything is working.

EXAMPLE

On Mac OS X 10.10.3 with Homebrew and Xcode installed (with the terms and conditions accepted), OCaml, OPAM, and Angicart can be installed with the following commands:

	$ git clone https://github.com/mnewberry/angicart.git
	$ brew install ocaml opam pcre sdl sdl_image
	$ opam init
	$ eval `opam config env`
	$ opam install batteries pcre lablgl ocamlsdl ounit
	$ cd angicart
	$ ./make.sh graphdisplay run --help

ImageMagick can be installed on such a system via MacPorts with the following command:

	$ sudo port install ImageMagick