Javadoc and @since in com.sun.source.tree

[Jonathan Gibbons]

On 07/29/2013 05:44 PM, Werner Dietl wrote:
> JSR 308 added a few methods/enum constants in com.sun.source.tree, e.g.:
>
> com.sun.source.tree.Tree.Kind.ANNOTATED_TYPE
> com.sun.source.tree.TypeParameterTree.getAnnotations()
>
> These currently have no Javadoc (which is consistent with the lack of
> Javadoc in other such classes) and no @since 1.8.
> As these classes are @jdk.Supported, I think it would be nice to
> document our changes.
> Should I add some first blurbs or is somebody else better suited?
>
> Cheers,
> cu, WMD.
>

The lack of javadoc in existing com.sun.source is not a good state of 
affairs.
Why don't you provide a first pass at what the text should be on the new 
items related to type-annotations.

-- Jon