[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
hargrave@xxxxxxxxxx

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