File: palcom/doc/setup/Eclipse-install.txt

1. Getting Eclipse

   A number of the tools for PalCom are developed using the Eclipse IDE.
   The PalCom projects are known to work with Eclipse version 3.3.

   To get Eclipse, go to 

      http://www.eclipse.org/downloads/

   and follow the instructions.

2. Getting the C++ plugin (CDT) for Eclipse

   For the PAL-VM virtual machine, you will furthermore need the C++
   Developer Toolkit (CDT) plugin.

   The procedure is described at, e.g. 
      http://www.mirrorservice.org/sites/download.eclipse.org/eclipseMirror/technology/phoenix/demos/install-cdt/callisto-cdt.html
   (Flash Player browser plugin required)

   The essentials are:

   Inside Eclipse do this

   a. Select Help->Software updates->Find and install
      (meaning: In menu "Help", select item "Software updates", and select
      submenu item "Find and install")

   b. Choose "Search for new features to install"

   c. Select "Callisto Discovery Site", press Finish
      
   d. Select a Callisto mirror site (e.g. the default)

   e. Unfold the Callisto Discovery Site tree presented, unfold the C
      and C++ Development leaf, and choose the newest version of CDT and
      press Finish.

3. Using SVN in Eclipse

   See Eclipse-SVN.txt

4. Java compiler version 

   There has been made an agreement to allow using Java 5.0 for the
   Java source files in PalCom (generics, annotations, etc.).
   And for some tools, this is currently being used.
   In eclipse this means that one should go to

     Window->Preferences->Java->Installed JREs  
         and select JRE 1.5 as default and
     Window->Preferences->Java->Compiler  
         and set Compiler Compliance Level to 5.0

   Furthermore you should add the appropriate Java 5.0 paths to your
   PATH environment variable.

   Please notice, that pal-j currently does NOT support Java 5.0
   features, so you cannot use these in source code that is to be
   compiled for running on the pal-vm itself.
   An augmented pal-j compiler with 5.0 features is expected started
   on mid 2006.
