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

Jonathan Gibbons jonathan.gibbons at
Mon Jul 29 17:54:37 PDT 2013

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 
Why don't you provide a first pass at what the text should be on the new 
items related to type-annotations.

-- Jon

More information about the type-annotations-dev mailing list