HOW TO BUILD ARDUINO ON YOUR FAVORITE PLATFORM


////////////////////////////////////////////////////////////////////

//// Steps for First Time Setup 


1. INSTALL DEVELOPMENT TOOLS

1a. On Windows, install Cygwin. It's downloadable from 
    www.cygwin.com or specifically: www.cygwin.com/setup.exe

** of the packages, begin with the defaults, and add:

+ svn - used for version control

+ make, gcc-mingw, and g++ - used to build arduino.exe
  (this will also pull in gcc-core)

+ perl - use this version, activestate or other distros have trouble
  
+ unzip, zip - for dealing with archives

+ included in the defaults, but make sure:
  coreutils (or textutils), gzip, tar

+ not required but useful: 
  openssh - command line ssh client
  nano - handy/simple text editor

** and be sure to leave the option selected for 'unix line endings' 

the cygwin installer is sometimes a little flakey, so it may take more 
than one try to get everything in there. in fact, it's often best to
run the installer once, and let it install all its defaults, then run 
it again, and select the items above. it's also useful to run the 
installer every few months to keep things fresh.


1b. On Mac OS X, install Apple's Developer Tools and subversion.

1c. On Linux, you're pretty much on your own.. You need jikes (or
    edit make.sh to use a different compiler), java, avr-gcc, make,
    and subversion.  You'll also have to set some environment
    variables (see make.sh for details).


2. GRAB THE CODE FROM BERLIOS

* this grabs the code as an anonymous user. 

# grab the code, it'll take a while
svn co svn://svn.berlios.de/arduino/trunk
# (maybe even a long while for you dialup and international folks)


3. BUILD IT

3a. On the Mac, use the Xcode project to build the Arduino software.
    Set the active target to App to run Arduino, or to Distribute to
    create a .zip file.

3b. On Windows or Linux, use the command line.

# on Windows
cd /path/to/arduino/build/windows

# or if you're on linux
cd /path/to/arduino/build/linux

# and then..
./make.sh

# if everything went well, you'll have no errors. (feel free to make
# suggestions for things to include here for common problems)

# then to run it
./run.sh

# each time you make a change, use make to build the thing 
# and run to get it up and running. 


////////////////////////////////////////////////////////////////////

//// Updating to the Latest Version


4a. Each time you want to update to latest version from svn:

cd /path/to/arduino
svn update


4b. If new folders have been added, or you're gettin odd errors, use:

# remove the work directory
rm -rf work

$Id$