--- On Thu, 3/19/09, James Carman <ja...@carmanconsulting.com> wrote:
> From: James Carman <ja...@carmanconsulting.com> > Subject: Re: [LANG] 3.0 JCIP Annotations > To: "Commons Developers List" <dev@commons.apache.org> > Date: Thursday, March 19, 2009, 1:14 AM > 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? *I* didn't know that the classes weren't required at RT... but I still don't know that we should consider that a blocker. Seems like a couple of well-placed warnings in documentation would take care of that pretty well. What does the annotation look like in the Javadoc? Because if the POM has it marked as optional (we can even include a comment there explaining further) then the Javadoc would be the only place left for a user to get the wrong idea. Adding our own annotation seems like NIH... -Matt > > --------------------------------------------------------------------- > 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
