#
#  '$RCSfile$'
#   '$Author: berkley $'
# '$Revision: 7258 $'
#     '$Date: 2008-05-22 15:02:42 -0700 (Thu, 22 May 2008) $'
#



--Build instructions. 
--For newer versions of linux, like ubuntu, you'll need to download scew 
version 0.3.1 and expat version 2.0.1 and compile them from source.  The
apt-get packages for scew and expat will not work.  

//Edit the Makefile.  Make sure the JAVA_HOME is set correctly and that the
//path to SCEW is set.  If you don't have SCEW, there is a tar.gz file
//in the lib directory that contains the needed files.

//LINUX
--------
//make the cpp code
make
//compile the shared library
//(gcc -Wall -g --shared *.o -o libgarp.so -lpthread -lscew -lexpat -lstdc++)
./makelib
//run kepler



//WINDOWS
---------
Compile and build the garp code with Microsoft Visual C++.  You can use the
VC++ project file garp.dsp to build the dll.  after the dll is built, copy it
to your c:\windows\system32 directory.  There is a prebuilt version of this
dll in the lib directory as well.  you should also copy the lib/libexpat.dll
file into the c:\windows\system32 directory.

//MAC OSX
---------
The differences between compiling and linking on linux vs. OSX are subtle but
important.  First, change the paths in the Makefile.mac to match your
JAVA_HOME and the location of scew.  Then copy Makefile.mac to Makefile.
(backup Makefile first if you ever want to be able to compile on linux)
You should then be able to run 'make' and the code will compile.  Next,
set your LD_LIBRARY_PATH env variable to $KEPLER/src/cpp/garp (don't use
$KEPLER, type in the full path).  the run makelib.mac.  you should get a
libgarp.dylib and a symlink called libgarp.jnilib.  You should now be able
to run kepler from within the kepler directory with 'ant run'.                      

Note: There is a graphic output from the GARP code in the format of a *.BMP file.
This is a Windows format and apparently the code does not check the ENDIAN of
the underlying OS. So this output is corrupt on a Mac while the *.asc output is
correct! --- Dan Higgins, March 22, 2006
