This document describes how to install\upgrade the C/C++ Development Toolkit.

Installing using install-cdt
----------------------------

A simple shell script has been provided that will check for an existing CDT
installation, back it up if required and install the new CDT.  The only piece
of information that you will need to know is the full path into which CDT 
is to be installed (this typically <some-directory>/eclipse/plugins).  
To run the installer, simply type:

./install-cdt     (on Linux or other Unix-Based systems) 
or 
sh install-cdt    (on Windows, assuming you have the cygwin package installed)

Once the installation is complete, you may also need to remove your "metadata".
Since eclipse persists UI information and fields or view names may have changed,
it may be necessary to remove the metadata for the CDT plugins.  If you find 
some runtime exceptions after installing CDT, try the following:

1. From a shell, navigate to where you invoke eclipse from.
2. There should be a ".metadata" or "workspace" directory there.
3. Navigate down to the workspace/.metadata/.plugins directory.
4. Remove any directories that match:
    "org.eclipse.cdt.*"
    "com.ibm.cpp.*"
    "com.ibm.dstore.*"
    "com.ibm.lpex"
    "com.ibm.debug.*"
   If the problems still exists after trying this and restarting eclipse, 
   you can try removing the entire ".metadata" directory.  If the problems 
   still exist then open a bug at http://bugs.eclipse.org


The rest of this document describes the process to manually install the CDT.
  
Upgrading
---------

If you have a previous version of the CDT installed, you should remove it before
installing the R1.0 driver.  To do this, remove the CDT plugins from your 
eclipse/plugins directory if you are sure that you have not installed any other
plugins whose names begin with "com.ibm" or "org.eclipse.cdt".  

 rm -rf <some_dir>/eclipse/plugins/com.ibm* <some_dir>/eclipse/plugins/org.eclipse.cdt*

If you have installed some other plugins whose names may also start with 
"com.ibm", or if you are not sure, then only delete the following plugins (if
they exist):

com.ibm.cpp.*
com.ibm.dstore.*
com.ibm.debug.*
com.ibm.lpex
com.ibm.linux.help
org.eclipse.cdt.*


Manual Installation
------------
To install the plugin for regular use, simply unzip cdt-eclipse-R1.0-local.zip 
into the eclipse/plugins directory:
     unzip cdt-eclipse-R1.0-local.zip -d <...>/eclipse/plugins
Once you have unzipped the CDT plugins into the eclipse/plugins directory,
the CDT should be ready for use.

To work with remote projects, you will need to install cdt-eclipse-R1.0-server.zip
on the remote machine.  
Refer to org.eclipse.cdt.cpp.docs.user/tasks/remote/server.htm for details.


Building
--------

To generate a build environment for the CDT plugins (which is not necessary to run 
the CDT), perform the following:
 1. Ensure that the cdt-eclipse-R1.0-local.zip has been unzipped in your 
    eclipse/plugins directory
 2. Goto the .../eclipse/plugins/org.eclipse.cdt.dstore.core directory
 3. Type make dev