Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [platform-ui-dev] Question regarding semantic versioning

Hi Dirk,

the rules are explained in
https://wiki.eclipse.org/Version_Numbering#Versioning_features

PerspectiveDescriptor is not API (see the x-internal flag in the
corresponding package, hence no since tag.

Best regards, Lars

On Tue, Jul 21, 2015 at 8:51 AM, Dirk Fauth <dirk.fauth@xxxxxxxxx> wrote:
> Hi,
>
> I have a question regarding OSGi semantic versioning for platform bundles.
>
> Yesterday I contributed a patch for an issue in the compat layer:
> https://git.eclipse.org/r/#/c/52228/
> For that bugfix I needed to introduce a new method in PerspectiveDescriptor.
>
> At night I remembered that I haven't updated the API baseline, and so I did
> this just now. From my knowledge of semantic versioning, adding a new public
> method should have lead to an error, because I forgot to add the @since tag
> for that new method. Also the API tooling should have complained that the
> version of the org.eclipse.ui.workbench plug-in needs to be increased. But
> there are no error messages from the API tooling. Looking at the MANIFEST,
> the package is marked as internal.
>
> Now I wonder, is something wrong in my workspace settings? Does the API
> tooling not complain because of the internal configuration?
>
> From my understanding I need to increase the bundle version and mark the new
> public method with an @since tag. Is that correct?
>
> I also noticed that the exported packages doesn't export the version.
> Regarding to correct OSGi semantic versioning, is this by design or by
> mistake?
>
> Sorry for the questions. I was asked the same questions for my projects in
> the past and I'm still trying to understand the whole semantic versioning
> stuff in detail. In theory it seems to be clear, but practically things are
> different.
>
> Greez,
> Dirk
>
> _______________________________________________
> platform-ui-dev mailing list
> platform-ui-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from
> this list, visit
> https://dev.eclipse.org/mailman/listinfo/platform-ui-dev



-- 
Eclipse Platform UI and e4 project co-lead
CEO vogella GmbH

Haindaalwisch 17a, 22395 Hamburg
Amtsgericht Hamburg: HRB 127058
Geschäftsführer: Lars Vogel, Jennifer Nerlich de Vogel
USt-IdNr.: DE284122352
Fax (032) 221739404, Email: lars.vogel@xxxxxxxxxxx, Web: http://www.vogella.com


Back to the top