How to compile columba under Eclipse

- create a directory as the columba workspace 

        mkdir %workspace%

- Extract columba source code 

	columba-win32-1.0_RC3-src.zip 

  into the following directory

	%workspace%/columba

- run eclipse with the columba workspace:

        eclipse -data %workspace%

   - close the welcome screen
- creat a columba project
   - in the ``package navigator", right click, choose 
     "new"/"project"/"java project from existing ant buildfile"
   - enter "%workspace%/columba/build.xml" as the Ant buildfile location
- fixing the compilation errors
  - edit .classpath

<?xml version="1.0" encoding="UTF-8"?>
<classpath>
	<!-- source code -->
	<classpathentry kind="src" path="src/addressbook/api"/>
	<classpathentry kind="src" path="src/addressbook/core"/>
	<classpathentry kind="src" path="src/addressbook/test"/>
	<classpathentry kind="src" path="src/columba/core"/>
	<classpathentry kind="src" path="src/columba/test"/>
	<classpathentry kind="src" path="src/mail/api"/>
	<classpathentry kind="src" path="src/mail/core"/>
	<classpathentry kind="src" path="src/mail/test"/>
	<classpathentry kind="src" path="res"/>
	<!-- junit 3.8.1 -->
	<classpathentry kind="var" path="ECLIPSE_HOME/plugins/org.junit_3.8.1/junit.jar"/>
	<!-- jre -->
	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
	<classpathentry kind="lib" path="lib/forms-1.0.5.jar"/>
	<classpathentry kind="lib" path="lib/jscf-0.3.jar"/>
	<classpathentry kind="lib" path="lib/commons-cli-1.0.jar"/>
	<classpathentry kind="lib" path="lib/jwizz-0.1.3.jar"/>
	<classpathentry kind="lib" path="lib/jhall.jar"/>
	<classpathentry kind="lib" path="lib/ristretto-1.0_RC3.jar"/>
	<classpathentry kind="lib" path="lib/macchiato-1.0pre1.jar"/>
	<classpathentry kind="lib" path="lib/frapuccino-1.0pre1.jar"/>
	<classpathentry kind="lib" path="lib/lucene-1.3-final.jar"/>
	<classpathentry kind="lib" path="lib/looks-1.3.1.jar"/>
	<classpathentry kind="lib" path="native/win32/lib/jniwrap-2.4.jar"/>
	<classpathentry kind="lib" path="native/win32/lib/winpack.jar"/>
	<classpathentry kind="lib" path="lib/jdom.jar"/>
	<classpathentry kind="lib" path="lib/jpim.jar"/>
	<classpathentry kind="lib" path="lib/je-1.7.1.jar"/>
	<classpathentry kind="lib" path="native/win32/lib/jdic.jar"/>
	<classpathentry kind="output" path="bin"/>
</classpath>

- remove unnecessary files
   - remove the directory "classes" 
   - delete the linked directory "api" 
   - delete "build.xml" src/*.build.xml src/*/build.xml
   - delete "maven.xml"
- compile plugins
  - create a separate eclipse projects for every plugin

	cd %workspace%/columba
	mv plugins/* ..

  - create a new Java project for each of these plugins
  - copy the .classpath from the columba and make similar modifications
- set the main class to run
   - extract columba.jar/META-INF

	jar xf columba.jar META-INF

   - removing the helpManager error: org.columba.core.help.HelpManager.java
     add the following line  to methods enableHelpOnButton, enableHelpKey

    	if (getHelpBroker()==null) return;

   - the main class is 
	org.columba.core.main.Main
   - run as Java application