hg: jdk8/tl/langtools: 7021614: extend com.sun.source API to support parsing javadoc comments

[jonathan.gibbons at oracle.com]

Changeset: 33abf479f202
Author:    jjg
Date:      2012-11-14 17:23 -0800
URL:       http://hg.openjdk.java.net/jdk8/tl/langtools/rev/33abf479f202

7021614: extend com.sun.source API to support parsing javadoc comments
Reviewed-by: ksrini, strarup

! make/build.xml
+ src/share/classes/com/sun/source/doctree/AttributeTree.java
+ src/share/classes/com/sun/source/doctree/AuthorTree.java
+ src/share/classes/com/sun/source/doctree/BlockTagTree.java
+ src/share/classes/com/sun/source/doctree/CommentTree.java
+ src/share/classes/com/sun/source/doctree/DeprecatedTree.java
+ src/share/classes/com/sun/source/doctree/DocCommentTree.java
+ src/share/classes/com/sun/source/doctree/DocRootTree.java
+ src/share/classes/com/sun/source/doctree/DocTree.java
+ src/share/classes/com/sun/source/doctree/DocTreeVisitor.java
+ src/share/classes/com/sun/source/doctree/EndElementTree.java
+ src/share/classes/com/sun/source/doctree/EntityTree.java
+ src/share/classes/com/sun/source/doctree/ErroneousTree.java
+ src/share/classes/com/sun/source/doctree/IdentifierTree.java
+ src/share/classes/com/sun/source/doctree/InheritDocTree.java
+ src/share/classes/com/sun/source/doctree/InlineTagTree.java
+ src/share/classes/com/sun/source/doctree/LinkTree.java
+ src/share/classes/com/sun/source/doctree/LiteralTree.java
+ src/share/classes/com/sun/source/doctree/ParamTree.java
+ src/share/classes/com/sun/source/doctree/ReferenceTree.java
+ src/share/classes/com/sun/source/doctree/ReturnTree.java
+ src/share/classes/com/sun/source/doctree/SeeTree.java
+ src/share/classes/com/sun/source/doctree/SerialDataTree.java
+ src/share/classes/com/sun/source/doctree/SerialFieldTree.java
+ src/share/classes/com/sun/source/doctree/SerialTree.java
+ src/share/classes/com/sun/source/doctree/SinceTree.java
+ src/share/classes/com/sun/source/doctree/StartElementTree.java
+ src/share/classes/com/sun/source/doctree/TextTree.java
+ src/share/classes/com/sun/source/doctree/ThrowsTree.java
+ src/share/classes/com/sun/source/doctree/UnknownBlockTagTree.java
+ src/share/classes/com/sun/source/doctree/UnknownInlineTagTree.java
+ src/share/classes/com/sun/source/doctree/ValueTree.java
+ src/share/classes/com/sun/source/doctree/VersionTree.java
+ src/share/classes/com/sun/source/doctree/package-info.java
! src/share/classes/com/sun/source/tree/Tree.java
+ src/share/classes/com/sun/source/util/DocTreeScanner.java
+ src/share/classes/com/sun/source/util/DocTrees.java
+ src/share/classes/com/sun/source/util/SimpleDocTreeVisitor.java
! src/share/classes/com/sun/source/util/Trees.java
! src/share/classes/com/sun/tools/javac/api/JavacTrees.java
! src/share/classes/com/sun/tools/javac/comp/Attr.java
! src/share/classes/com/sun/tools/javac/comp/AttrContext.java
! src/share/classes/com/sun/tools/javac/comp/Env.java
! src/share/classes/com/sun/tools/javac/comp/Resolve.java
+ src/share/classes/com/sun/tools/javac/parser/DocCommentParser.java
! src/share/classes/com/sun/tools/javac/parser/JavacParser.java
! src/share/classes/com/sun/tools/javac/parser/JavadocTokenizer.java
+ src/share/classes/com/sun/tools/javac/parser/LazyDocCommentTable.java
! src/share/classes/com/sun/tools/javac/parser/ParserFactory.java
- src/share/classes/com/sun/tools/javac/parser/SimpleDocCommentTable.java
! src/share/classes/com/sun/tools/javac/resources/compiler.properties
+ src/share/classes/com/sun/tools/javac/tree/DCTree.java
! src/share/classes/com/sun/tools/javac/tree/DocCommentTable.java
+ src/share/classes/com/sun/tools/javac/tree/DocPretty.java
+ src/share/classes/com/sun/tools/javac/tree/DocTreeMaker.java
! src/share/classes/com/sun/tools/javadoc/DocEnv.java
! src/share/classes/com/sun/tools/javadoc/SeeTagImpl.java
! test/tools/javac/diags/CheckExamples.java
+ test/tools/javac/diags/DocCommentProcessor.java
! test/tools/javac/diags/Example.java
! test/tools/javac/diags/RunExamples.java
! test/tools/javac/diags/examples.not-yet.txt
+ test/tools/javac/diags/examples/BadEntity.java
+ test/tools/javac/diags/examples/BadGreaterThan.java
+ test/tools/javac/diags/examples/BadInlineTag.java
+ test/tools/javac/diags/examples/GreaterThanExpected.java
+ test/tools/javac/diags/examples/MalformedHTML.java
+ test/tools/javac/diags/examples/MissingSemicolon.java
+ test/tools/javac/diags/examples/NoTagName.java
+ test/tools/javac/diags/examples/RefBadParens.java
+ test/tools/javac/diags/examples/RefIdentifierExpected.java
+ test/tools/javac/diags/examples/RefSyntaxError.java
+ test/tools/javac/diags/examples/RefUnexpectedInput.java
+ test/tools/javac/diags/examples/UnexpectedContent.java
+ test/tools/javac/diags/examples/UnterminatedInlineTag.java
+ test/tools/javac/diags/examples/UnterminatedSignature.java
+ test/tools/javac/doctree/AttrTest.java
+ test/tools/javac/doctree/AuthorTest.java
+ test/tools/javac/doctree/BadTest.java
+ test/tools/javac/doctree/CodeTest.java
+ test/tools/javac/doctree/DeprecatedTest.java
+ test/tools/javac/doctree/DocCommentTester.java
+ test/tools/javac/doctree/DocRootTest.java
+ test/tools/javac/doctree/ElementTest.java
+ test/tools/javac/doctree/EntityTest.java
+ test/tools/javac/doctree/ExceptionTest.java
+ test/tools/javac/doctree/FirstSentenceTest.java
+ test/tools/javac/doctree/InheritDocTest.java
+ test/tools/javac/doctree/LinkPlainTest.java
+ test/tools/javac/doctree/LinkTest.java
+ test/tools/javac/doctree/LiteralTest.java
+ test/tools/javac/doctree/ParamTest.java
+ test/tools/javac/doctree/ReferenceTest.java
+ test/tools/javac/doctree/ReturnTest.java
+ test/tools/javac/doctree/SeeTest.java
+ test/tools/javac/doctree/SerialDataTest.java
+ test/tools/javac/doctree/SerialFieldTest.java
+ test/tools/javac/doctree/SerialTest.java
+ test/tools/javac/doctree/SimpleDocTreeVisitorTest.java
+ test/tools/javac/doctree/SinceTest.java
+ test/tools/javac/doctree/TagTest.java
+ test/tools/javac/doctree/ThrowableTest.java
+ test/tools/javac/doctree/ValueTest.java
+ test/tools/javac/doctree/VersionTest.java