****************************************************************************
 
 Copyright (C) 2004-2007 HP-GCC Development Team

 ****************************************************************************


 This file is part of HP-GCC.

 HP-GCC is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2, or (at your option)
 any later version.
 
 HP-GCC is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with HP-GCC; see the file COPYING. 

 As a special exception, you may use this file as part of a free software
 library without restriction.  Specifically, if other files instantiate
 templates or use macros or inline functions from this file, or you compile
 this file and link it with other files to produce an executable, this
 file does not by itself cause the resulting executable to be covered by
 the GNU General Public License.  This exception does not however
 invalidate any other reasons why the executable file might be covered by
 the GNU General Public License.

 ****************************************************************************


***************************
* HP-GCC 2.0 Installation *
***************************


I. Install ARM-Toolbox v 3.12
=============================

1. Locate the file "SETUP.BIN" in the sources/ARMToolbox folder.
2. Transfer this file to your calculator.
3. Enter a (real) port number, where you want the library to live, on the stack.
4. Push the SETUP.BIN on the stack.
5. Press EVAL
6. Warm start your calculator


II. Install arm-elf gcc 4.1.1 and binutils 2.17
===============================================
( These are mandatory for HP-GCC 2.0 to work! )

1. Locate the tar file "arm-elf-gcc-4.1.1-x86-linux2.tar" in the distribution's root folder
2. su to become root
3. Enter tar xvC /usr/local -f arm-elf-gcc-4.1.1-x86-linux2.tar
   This installs the package in /usr/local
3. ^D to become a user again
4. Add the following lines to your .bashrc:
    
    export HPGCC=/path/to/hpgcc_20
    export PATH=$PATH:$HPGCC/bin
    
( For csh change appropriately ... )

You are set.
Since the distribution comes with precompiled binary libraries, you can start to work right now.
Or, if you want to rebuild the libraries from sources:

1.) cd sources
2.) make clean ; make install

Remember that you'll need doxygen, to rebuild the documentation.

To test your installation:

1. cd examples
2. dmake

This should produce a bunch of *.hp files, ready to use on your calculator.

The HPGCC Team
February 2007