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

Reply via email to