New README

[Per Johan Groland]

Hi,

I've written a new more general readme, which will cater for all the
different ports that will (hopefully) be added to the CVS.

Please have a look and change and update things as you see fit.

PS: I'm ready to add the Pocket PC version to CVS as soon as I get
a user name.

-------------------------------------------------------------
JuggleMaster


1. GENERAL

JuggleMaster is a juggling siteswap animator. It can animate any valid
siteswap, and has a large library of patterns included.

If you want to learn siteswap, check out http://www.siteswap.org/

JuggleMaster was originally written in C by Ken Matsuoka for DOS. It was
later
ported to C++ as a platform independent library (called jmlib) by Per Johan
Groland, who also ported it to Palm OS and Pocket PC. It was later ported
to wxWidgets by Gary ??? (which allows it to run on a variety of platforms
including Linux, Windows and MacOS).

The platforms currently available:

JMDlx        wxWidgets   http://icculus.org/jugglemaster/
JMPocket     Pocket PC   http://jugglemaster.net
JMPalm       Palm OS     http://jugglemaster.net (no open-source version
available)
AAJM         aalib       http://icculus.org/jugglemaster/

The weblinks above will direct you to the proper sites to download
binaries for the various platforms. For the source code, go to
http://icculus.org/jugglemaster/

In the "docs" dir, you'll find Ken Matsuoka's original README, and Isaac
Orr's readme from the Java version [which has a better description of
how to edit the pattern files].

2. BUILDING

Build instructions and requirements vary between the different platforms.

JMDlx

To build, just go into the src/jmdlx dir and type "make". It creates a
binary "jmdlx". Run it. You need wxWidgets, available from
http://www.wxwidgets.org.

To build it on Windows using Visual Studio, you need to set up the
project file yourself. The wxWidgets home page includes instructions.
If you don't have Visual Studio, either work it out yourself, or extract
bloodshed.zip and use the excellent DevC++ from www.bloodshed.net

To build on OSX, go into src/jmdlx and type "make osx". It'll create
JuggleMaster.app right there.

If you don't have patterns.jm and semaphore.jm in the current dir when
you run it, it attempts to download them and save them to a suitable
dir. You'll find copies in the "data" dir, so you can just copy them
across if you want.

JMPocket

To build JMPocket you need Microsoft eMbedded Visual Tools 3.0 2002 Edition,
available free of charge from Microsofts web page. JMPocket doesn't run
properly
in the Pocket PC 2002 emulator, so you will also need to download the
Pocket PC
2000 SDK. The downloads can all be found at http://download.microsoft.com

A properly configured project file is included in src/jmpocket/JMPocket.vcw

JMPocket expects to find the pattern libary in My Documents, and it must be
named either patt_e.jm or patterns.jm.

AAJM

<add build instructions here>