Choosing not to include it in Javadocs it is fine if we are certain
that it is of no value, or is detrimental in some way.  I don't see
how it it would be detrimental, and it might be useful to some people,
so I would prefer to include it.

Or let me put it this way - if annotations were *included* in Javadocs
by default (as opposed to being *excluded* by default), I wouldn't be
able to suggest a good reason to *exclude* the @BXML annotation.

On 8 August 2011 21:07, Greg Brown <gk_br...@verizon.net> wrote:
>> I'm not saying that it would help to enhance the Pivot API Javadocs in
>> any way.  Just that it would be there for Pivot consumers when they
>> generate Javadocs for their own code that uses @BXML.
>
> @BXML is primarily meant for application, not platform, usage anyways, so 
> that's OK. I'm just wondering about the overall utility of adding the 
> @Documented annotation to it, since most of the time your @BXML-annotated 
> fields are going to be private, and (I'd guess that) most Javadoc does not 
> include private members.
>
>

Reply via email to