[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [equinox-dev] .qualifier for export package?

> Right, but since package versions will now evolve independently of bundle
> versions, should the package name also appear in the @since tag - like
> "@since org.eclipse.jdt.debug.model 3.4". Else, when just looking at the
> Javadoc, consumers of an API will not know if they need a required bundle
> or a package import.

Wouldn't the package name already be stated by the package statement at the head of the source code? It seem redundant and repetitive to put it in the @since tag.

I think @since obviously applies to the package. When you javadoc the code, bundle membership is absent. Only the package organization remains.

BJ Hargrave
Senior Technical Staff Member, IBM
OSGi Fellow and CTO of the
OSGi Alliance

office: +1 386 848 1781
mobile: +1 386 848 3788