Darin Wright Eclipse Debug Lead, Rational Team, IBM Canada (204)938-8051 [EMAIL PROTECTED] wrote on 09/02/2008 01:59:00 PM:
> > > Here are some obvious questions: > > > > * How are @since tags formatted to indicate that the version number > > corresponds to packages vs. bundles? > > If there is a package version then the @since should always reference > the package version exported in my opinion. 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. > > > * How are initial package versions derived for existing bundles? > > The simple answer here is to seed the package versions with the > bundle's version. This makes some sense because using the Eclipse > versioning rules today the API packages from a single bundle are > versioned together as one unit using the Bundle-Version. Another option is to use the highest @since tag in the package. If a most recent since tag in a package is 3.1, it could start at 3.1 instead of 3.5. Darin _______________________________________________ equinox-dev mailing list [email protected] https://dev.eclipse.org/mailman/listinfo/equinox-dev
