Instructions for Linux Build

Note that this is all likely to change as we re-engineer how things work.  Also, individual Linux distributions are slightly different.

1) Obtain toolchain
   
   gnuarm-3.4.3.tar.gz
   
2) Unpack into a working directory
   
   tar -zxvf gnuarm-3.4.3.tar.gz

   This will result in a directory being created called gnuarm-3.4.3 
   which contains several directories (arm-elf, bin, lib, etc.)

3) Copy into /usr/local

   sudo cp -R gnuarm-3.4.3 /usr/local

   This will copy the files into /usr/local
      
4) Add the toolchain to your path

   export PATH=/usr/local/gnuarm-3.4.3/bin:$PATH
   
5) Confirm the presence of the compiler

   \>arm-elf-gcc --version
   arm-elf-gcc (GCC) 3.4.3
   Copyright (C) 2004 Free Software Foundation, Inc.
   This is free software; see the source for copying conditions.  There is NO
   warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
   
6) Obtain Code

   This can be any New Spirit program.
   
7) Navigate into one of the code directories, such as

	EX00_template
	EX01_structure
	EX02_Sleeping
	EX03_Moving
     
8) Ideally, we would navigate into these apps, type make and we'd be done, but 
they are not quite right.

  a) Each directory contains a makefile.  They are the files that end in .mak
  Invoke make as follows, making sure FILENAME.mak is replaced by the appropriate
  file name:
  
    make -f FILENAME.mak
    
  b) This would normally work, except there's an error in the Makefiles. The 
  include directive needs to be changed.  The -I directive refers to the incorrect
  include directory.  For example:

    CFLAGS = -O0 -IE:/SPYbot/APP_Kim/VoiceThrowing04/Include -Wall -gstabs+  

  needs to be changed to 

    CFLAGS = -O0 -IInclude -Wall -gstabs+
 
  the build then proceeds.