On 19/03/2009, James Carman <ja...@carmanconsulting.com> wrote: > On Wed, Mar 18, 2009 at 10:21 PM, Stephen Colebourne > <scolebou...@btopenworld.com> wrote: > > > > Thats OK technically (as there is no runtime dependency on > > net.jcip.annotations). However, I suspect it will confuse users, as very > few > > people realise that no dependency is created beyond compilation time. > > > > > I agree. Most folks don't know that there annotation classes aren't > really required at runtime. If we're just looking for documentation, > can't we have our own doclet? >
The fact that the annotations are included in the Javadoc is a bonus, not a requirement. The thread-safety information needs to be present, anyway. Using annotations means that automated tools such as Findbugs can generate a warning if the requirements are not met, as well as documenting the behaviour for future maintenance. > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org > > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org