[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.

OK, this would be a good argument to have initial package versions reflect 
the highest @since tag in the package, rather than the current bundle 
version. Else we'd have a mix of @since tags in existing bundles - where 
some referenced the bundle version, and some referenced the package 
version.

Darin