Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[ptp-dev] @since concepts and use

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

Back to the top