Brian,
Prior to a release, the API baseline should always be the previous release version (5.0.0, 6.0.0, etc.) Once a release has occurred, the baseline should be changed to that release. Baselines are always the initial release version, not service release versions.
This would be (b) in your list.
The API tooling will indicate an error if you need to change the manifest version and/or add @since. It should provide you with a quick fix that will have the version you should use.
Regards, Greg On Oct 3, 2012, at 3:09 PM, Brian Watt wrote: Hi all,
I'm starting to do some ETFw work. In it I will be making changes to the ETFw API. As a result I want to make sure I'm doing the @since versioning appropriately. Naturally I'm basing my work on the latest master code from our GIT repository. Also Wyatt has already made some API changes which I need to base my changes upon.
Given the following:
1. The ptp-master for 5.0.0 (ptp-master-5.0.0-I201106140904.zip) has an org.eclipse.ptp.etfw jar with Bundle-Version of 4.0.0.201106140904
2. The ptp-master for 6.0.0 (ptp-master-6.0.0-201206130212.zip) has an org.eclipse.ptp.etfw jar with Bundle-Version of 5.0.0.201206130201
3. The ptp-master for 6.0.2 (ptp-master-6.0.2-201209190527.zip) has an org.eclipse.ptp.etfw jar with Bundle-Version of 5.0.0.201209181406
What do I set my Window > Preferences > Plug-in Development > API Baselines to, that is, which unzipped directory? (a) ptp-master-5.0.0-I201106140904.zip, (b) ptp-master-6.0.0-201206130212.zip, (c) ptp-master-6.0.2-201209190527.zip, latest nightly, or something else? I assume ptp-master-6.0.0-201206130212.zip.
Do I leave or change the org.eclipse.ptp.etfw jar's manifest bundle from version 5.0.0 to 6.0.0 or something else? I assume I change it to 6.0.0 because I've added new APIs and in preparation for the Kepler release
Do I mark my API changes @since 5.0 or @since 6.0 or something else? I assume I use @since 6.0 based upon changing the the bundle version.
Any help and insights and clarifications would be appreciated.
Brian Watt, IBM _______________________________________________ ptp-dev mailing list ptp-dev@xxxxxxxxxxx https://dev.eclipse.org/mailman/listinfo/ptp-dev
|