I've been working through RFPL-1959, adding descriptions to the various component attributes so we have a meaningful generated tag library doc (VDL doc). Things are going for the most part well, but's it's a PITA with so many components defining their attributes in different ways.
One that has me stuck is the attribute descriptions for the a4j:repeat (and other iteration components). UIRepeat extends UISequence, which in turn extends UIDataAdaptor. The attributes for UIRepeat are picked up from the parent classes, but adding the descriptions to the UISequence and UIDataAdaptor @Attribute annotations has no effect (neither with a @Description annotation, nor via javadoc).
Searching throughout the codebase does indicate these attributes are defined anywhere else. I'm at a loss for why the descriptions of the @Attribute annotations in UISequence and UIData classes isn't being picked up - anyone have any ideas?
I debugged through the CDK generation of the taglibs, and got as far as the JDK call to get the javadoc, which comes back as null. I'm thinking it must be a JDK error, something along the lines of: http://bugs.sun.com/view_bug.do?bug_id=6985205.
I've worked around the problem by creating a iteration-props.xml file to provide the attribute descriptions.