Introduction

This guide is for new users who wish to build Blackthorn from source. This guide attempts to be as short as possible, and thus does not provide any explanation for the method used. For a longer version which includes explainations, see the Installation Guide.

There are many ways to set up a Lisp development environment. For simplicity, I have chosen a single method to explain in this guide. If you know enough to disagree with the method chosen, then this guide is not for you.

Installation

• Install Mercurial.
• Install SBCL.
• Download the Blackthorn Starter Pack for Windows, Mac OS X, or Linux or BSD. Extract anywhere. Open a terminal and run:

cd blackthorn-starter-pack
sbcl --load setup.lisp

• Download Blackthorn using Mercurial. You can put it inside the blackthorn-starter-pack directory, or somewhere else.

hg clone https://blackthorn-engine.googlecode.com/hg/ blackthorn

Windows Only

• If you want to use the Makefile, install Cygwin. Be sure to install the make package, listed under devel.

Linux or BSD

• Install SDL, SDL_image, and SDL_mixer. There are just too many platforms for me to provide binaries for everyone. Use your disto's package manager if that is convenient for you. For example, Ubuntu users can do this with:

sudo apt-get install libsdl1.2-dev libsdl-image1.2-dev libsdl-mixer1.2-dev

Running

Open a terminal, change directory to where you downloaded Blackthorn, and run

make

For Windows users who chose NOT to install Cygwin, you'll have to run it manually,

sbcl --load load.lisp

If you don't like doing that, then go install Cygwin now.