> 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
[EMAIL PROTECTED]

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


_______________________________________________
equinox-dev mailing list
[email protected]
https://dev.eclipse.org/mailman/listinfo/equinox-dev

Reply via email to