Ebuilds Notes

Eclipse 3.3

• The Ant script creates a .tar.gz file at the end. We need to unpack it to perform further modifications.

• To create this .tar.gz, stuff is copied from the build directory. We need to remove this copying in the main build.xml file, as we will later create the symlinks to our system jars.

• The Javadoc is ran by the build file buildDoc.xml in plugins/org.eclipse.platform.doc.isv. You could disable it here, or if you want to produce the javadoc, you need to add some classpath entries. Note that the warnings about multiple sources for comments is an upstream problem.

• OSGi Manifests: if you have a header spanning several lines, it is *imperative* that you start newlines with a space!! Else this is considered to be another header.

• Eclipse imperatively expects the Ant jar to be "exploded", eg in folder form. So we must keep a org.apache.ant folder with inside a manifest and a lib dir. We will symlink to the system jars in lib/. Keep the manifest bundle classpath up-to-date with the actual symlinks, else errors appear on the log (Eclipse tries to find jars that are not present).

• In 3.3, the help system has been switched to the Jetty container. Tomcat is no longer needed (except for external plugins still not migrated to the new system). In 3.4, Tomcat is removed alltogether.

• Eclipse Tasks:
  • Fix the Help system (org.eclipse.osgi.service)
  • Unbundle the rest of the dependencies (jars): jetty, lucene, servlets and jsps.
  • Update to Eclipse 3.3.1
  • Make all the changes as patches
  • Remove the last compiled classes
  • Do something about ant tasks (optionals)
  • Polish the OSGi class (add automatic versionning and documentation).