Skip to content

Incrementing Version Numbers

Simeon Andreev edited this page May 24, 2023 · 1 revision

Each release of the Eclipse project, version numbers need updating in various places to indicate the version of the release. This page enumerates all the places where version numbers are written, for use as a checklist each release to ensure we update all version numbers correctly.

Note from 07/26/2012: any of those in 'eclipsebuilder' have been automated, where ant variables known at build time, are filled in before the build actually start. This is true any place you see @eclipseStream@ which is filled in (replaced) by the value of ant variable ${eclipseStream}. eclipseStream is all three digits of a release, such as 4.3.0, or 3.8.1. There are also more fine-grained values of ${eclipseStreamMajor} and ${eclipseStreamMinor} if needed, which would be, if stream was 3.8.1, 3 and 8 respectively.

Product versions

  • org.eclipse.releng.eclipsebuilder/eclipse/buildConfigs/platform/platform.product
  • org.eclipse.releng.eclipsebuilder/eclipse/buildConfigs/platform.sdk/platform.product
  • org.eclipse.releng.eclipsebuilder/eclipse/buildConfigs/sdk/builder/sdk.product
  • org.eclipse.platform-feature/rootfiles/.eclipseproduct
  • org.eclipse.releng.basebuilder/.eclipseproduct

Feature versions

Generally feature versions need updating because some plugins have had changes:

  • org.eclipse.sdk-feature/org.eclipse.platform-feature/feature.xml
  • org.eclipse.sdk-feature/org.eclipse.sdk/feature.xml
  • org.eclipse.sdk-feature/org.eclipse.rcp/feature.xml

Other features updated as needed (CVS, help, JDT, PDE, p2 ui)

Plugin versions

The feature branding plugin versions should match the version of their feature:

  • org.eclipse.platform/META-INF/MANIFEST.MF
  • org.eclipse.sdk/META-INF/MANIFEST.MF

If the doc plugins have changed, their version should match the version of the feature they provide doc for. Since doc plugins don't provide any code, usual version evolution guidelines don't apply:

  • org.eclipse.platform.doc.user/META-INF/MANIFEST.MF
  • org.eclipse.platform.doc.isv/META-INF/MANIFEST.MF

Other places

Feature blurbs (shown in about dialog when selecting a single feature):

  • org.eclipse.platform/about.properties
  • org.eclipse.sdk/about.properties

Product blurbs (shown in main about dialog):

  • org.eclipse.platform/plugin.properties
  • org.eclipse.sdk/plugin.properties