> 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.