jjg@1409: /*
jjg@1409:  * Copyright (c) 2011, 2012, Oracle and/or its affiliates. All rights reserved.
jjg@1409:  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
jjg@1409:  *
jjg@1409:  * This code is free software; you can redistribute it and/or modify it
jjg@1409:  * under the terms of the GNU General Public License version 2 only, as
jjg@1409:  * published by the Free Software Foundation.  Oracle designates this
jjg@1409:  * particular file as subject to the "Classpath" exception as provided
jjg@1409:  * by Oracle in the LICENSE file that accompanied this code.
jjg@1409:  *
jjg@1409:  * This code is distributed in the hope that it will be useful, but WITHOUT
jjg@1409:  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
jjg@1409:  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
jjg@1409:  * version 2 for more details (a copy is included in the LICENSE file that
jjg@1409:  * accompanied this code).
jjg@1409:  *
jjg@1409:  * You should have received a copy of the GNU General Public License version
jjg@1409:  * 2 along with this work; if not, write to the Free Software Foundation,
jjg@1409:  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
jjg@1409:  *
jjg@1409:  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
jjg@1409:  * or visit www.oracle.com if you need additional information or have any
jjg@1409:  * questions.
jjg@1409:  */
jjg@1409: 
jjg@1409: package com.sun.tools.javac.tree;
jjg@1409: 
jjg@1409: 
jjg@1409: import javax.tools.Diagnostic;
jjg@1409: 
jjg@1409: import com.sun.source.doctree.*;
jjg@1409: import com.sun.tools.javac.parser.Tokens.Comment;
jjg@1409: import com.sun.tools.javac.util.Assert;
jjg@1409: import com.sun.tools.javac.util.DiagnosticSource;
jjg@1409: import com.sun.tools.javac.util.JCDiagnostic;
jjg@1409: import com.sun.tools.javac.util.JCDiagnostic.SimpleDiagnosticPosition;
jjg@1409: import com.sun.tools.javac.util.List;
jjg@1409: import com.sun.tools.javac.util.Name;
jjg@1455: import java.io.IOException;
jjg@1455: import java.io.StringWriter;
jjg@1409: import javax.tools.JavaFileObject;
jjg@1409: 
jjg@1409: /**
jjg@1409:  * <p><b>This is NOT part of any supported API.
jjg@1409:  * If you write code that depends on this, you do so at your own risk.
jjg@1409:  * This code and its internal interfaces are subject to change or
jjg@1409:  * deletion without notice.</b>
jjg@1409:  */
jjg@1409: public abstract class DCTree implements DocTree {
jjg@1409: 
jjg@1409:     /**
jjg@1409:      * The position in the comment string.
jjg@1409:      * Use {@link #getSourcePosition getSourcePosition} to convert
jjg@1409:      * it to a position in the source file.
jjg@1409:      *
jjg@1409:      * TODO: why not simply translate all these values into
jjg@1409:      * source file positions? Is it useful to have string-offset
jjg@1409:      * positions as well?
jjg@1409:      */
jjg@1409:     public int pos;
jjg@1409: 
jjg@1409:     public long getSourcePosition(DCDocComment dc) {
jjg@1409:         return dc.comment.getSourcePos(pos);
jjg@1409:     }
jjg@1409: 
jjg@1409:     public JCDiagnostic.DiagnosticPosition pos(DCDocComment dc) {
jjg@1409:         return new SimpleDiagnosticPosition(dc.comment.getSourcePos(pos));
jjg@1409:     }
jjg@1409: 
jjg@1455:     /** Convert a tree to a pretty-printed string. */
jjg@1455:     @Override
jjg@1455:     public String toString() {
jjg@1455:         StringWriter s = new StringWriter();
jjg@1455:         try {
jjg@1455:             new DocPretty(s).print(this);
jjg@1455:         }
jjg@1455:         catch (IOException e) {
jjg@1455:             // should never happen, because StringWriter is defined
jjg@1455:             // never to throw any IOExceptions
jjg@1455:             throw new AssertionError(e);
jjg@1455:         }
jjg@1455:         return s.toString();
jjg@1455:     }
jjg@1455: 
jjg@1409:     public static class DCDocComment extends DCTree implements DocCommentTree {
jjg@1409:         final Comment comment; // required for the implicit source pos table
jjg@1409: 
jjg@1409:         public final List<DCTree> firstSentence;
jjg@1409:         public final List<DCTree> body;
jjg@1409:         public final List<DCTree> tags;
jjg@1409: 
jjg@1409:         public DCDocComment(Comment comment,
jjg@1409:                 List<DCTree> firstSentence, List<DCTree> body, List<DCTree> tags) {
jjg@1409:             this.comment = comment;
jjg@1409:             this.firstSentence = firstSentence;
jjg@1409:             this.body = body;
jjg@1409:             this.tags = tags;
jjg@1409:         }
jjg@1409: 
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.DOC_COMMENT;
jjg@1409:         }
jjg@1409: 
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitDocComment(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         public List<? extends DocTree> getFirstSentence() {
jjg@1409:             return firstSentence;
jjg@1409:         }
jjg@1409: 
jjg@1409:         public List<? extends DocTree> getBody() {
jjg@1409:             return body;
jjg@1409:         }
jjg@1409: 
jjg@1409:         public List<? extends DocTree> getBlockTags() {
jjg@1409:             return tags;
jjg@1409:         }
jjg@1409: 
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static abstract class DCBlockTag extends DCTree implements InlineTagTree {
jjg@1409:         public String getTagName() {
jjg@1409:             return getKind().tagName;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static abstract class DCInlineTag extends DCTree implements InlineTagTree {
jjg@1409:         public String getTagName() {
jjg@1409:             return getKind().tagName;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCAttribute extends DCTree implements AttributeTree {
jjg@1409:         public final Name name;
jjg@1409:         public final ValueKind vkind;
jjg@1409:         public final List<DCTree> value;
jjg@1409: 
jjg@1409:         DCAttribute(Name name, ValueKind vkind, List<DCTree> value) {
jjg@1409:             Assert.check((vkind == ValueKind.EMPTY) ? (value == null) : (value != null));
jjg@1409:             this.name = name;
jjg@1409:             this.vkind = vkind;
jjg@1409:             this.value = value;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.ATTRIBUTE;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitAttribute(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Name getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public ValueKind getValueKind() {
jjg@1409:             return vkind;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<DCTree> getValue() {
jjg@1409:             return value;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCAuthor extends DCInlineTag implements AuthorTree {
jjg@1409:         public final List<DCTree> name;
jjg@1409: 
jjg@1409:         DCAuthor(List<DCTree> name) {
jjg@1409:             this.name = name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.AUTHOR;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitAuthor(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCComment extends DCTree implements CommentTree {
jjg@1409:         public final String body;
jjg@1409: 
jjg@1409:         DCComment(String body) {
jjg@1409:             this.body = body;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.COMMENT;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitComment(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public String getBody() {
jjg@1409:             return body;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCDeprecated extends DCBlockTag implements DeprecatedTree {
jjg@1409:         public final List<DCTree> body;
jjg@1409: 
jjg@1409:         DCDeprecated(List<DCTree> body) {
jjg@1409:             this.body = body;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.DEPRECATED;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitDeprecated(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getBody() {
jjg@1409:             return body;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCDocRoot extends DCInlineTag implements DocRootTree {
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.DOC_ROOT;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitDocRoot(this, d);
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCEndElement extends DCTree implements EndElementTree {
jjg@1409:         public final Name name;
jjg@1409: 
jjg@1409:         DCEndElement(Name name) {
jjg@1409:             this.name = name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.END_ELEMENT;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitEndElement(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Name getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCEntity extends DCTree implements EntityTree {
jjg@1409:         public final Name name;
jjg@1409: 
jjg@1409:         DCEntity(Name name) {
jjg@1409:             this.name = name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.ENTITY;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitEntity(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Name getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCErroneous extends DCTree implements ErroneousTree, JCDiagnostic.DiagnosticPosition {
jjg@1409:         public final String body;
jjg@1409:         public final JCDiagnostic diag;
jjg@1409: 
jjg@1409:         DCErroneous(String body, JCDiagnostic.Factory diags, DiagnosticSource diagSource, String code, Object... args) {
jjg@1409:             this.body = body;
jjg@1409:             this.diag = diags.error(diagSource, this, code, args);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.ERRONEOUS;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitErroneous(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public String getBody() {
jjg@1409:             return body;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Diagnostic<JavaFileObject> getDiagnostic() {
jjg@1409:             return diag;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public JCTree getTree() {
jjg@1409:             return null;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public int getStartPosition() {
jjg@1409:             return pos;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public int getPreferredPosition() {
jjg@1409:             return pos + body.length() - 1;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public int getEndPosition(EndPosTable endPosTable) {
jjg@1409:             return pos + body.length();
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCIdentifier extends DCTree implements IdentifierTree {
jjg@1409:         public final Name name;
jjg@1409: 
jjg@1409:         DCIdentifier(Name name) {
jjg@1409:             this.name = name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.IDENTIFIER;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitIdentifier(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Name getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCInheritDoc extends DCInlineTag implements InheritDocTree {
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.INHERIT_DOC;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitInheritDoc(this, d);
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCLink extends DCInlineTag implements LinkTree {
jjg@1409:         public final Kind kind;
jjg@1409:         public final DCReference ref;
jjg@1409:         public final List<DCTree> label;
jjg@1409: 
jjg@1409:         DCLink(Kind kind, DCReference ref, List<DCTree> label) {
jjg@1409:             Assert.check(kind == Kind.LINK || kind == Kind.LINK_PLAIN);
jjg@1409:             this.kind = kind;
jjg@1409:             this.ref = ref;
jjg@1409:             this.label = label;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return kind;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitLink(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public ReferenceTree getReference() {
jjg@1409:             return ref;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getLabel() {
jjg@1409:             return label;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCLiteral extends DCInlineTag implements LiteralTree {
jjg@1409:         public final Kind kind;
jjg@1409:         public final DCText body;
jjg@1409: 
jjg@1409:         DCLiteral(Kind kind, DCText body) {
jjg@1409:             Assert.check(kind == Kind.CODE || kind == Kind.LITERAL);
jjg@1409:             this.kind = kind;
jjg@1409:             this.body = body;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return kind;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitLiteral(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public DCText getBody() {
jjg@1409:             return body;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCParam extends DCBlockTag implements ParamTree {
jjg@1409:         public final boolean isTypeParameter;
jjg@1409:         public final DCIdentifier name;
jjg@1409:         public final List<DCTree> description;
jjg@1409: 
jjg@1409:         DCParam(boolean isTypeParameter, DCIdentifier name, List<DCTree> description) {
jjg@1409:             this.isTypeParameter = isTypeParameter;
jjg@1409:             this.name = name;
jjg@1409:             this.description = description;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.PARAM;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitParam(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public boolean isTypeParameter() {
jjg@1409:             return isTypeParameter;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public IdentifierTree getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getDescription() {
jjg@1409:             return description;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCReference extends DCTree implements ReferenceTree {
jjg@1409:         public final String signature;
jjg@1409: 
jjg@1409:         // The following are not directly exposed through ReferenceTree
jjg@1409:         // use DocTrees.getElement(TreePath,ReferenceTree)
jjg@1409:         public final JCTree qualifierExpression;
jjg@1409:         public final Name memberName;
jjg@1409:         public final List<JCTree> paramTypes;
jjg@1409: 
jjg@1409: 
jjg@1409:         DCReference(String signature, JCTree qualExpr, Name member, List<JCTree> paramTypes) {
jjg@1409:             this.signature = signature;
jjg@1409:             qualifierExpression = qualExpr;
jjg@1409:             memberName = member;
jjg@1409:             this.paramTypes = paramTypes;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.REFERENCE;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitReference(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public String getSignature() {
jjg@1409:             return signature;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCReturn extends DCBlockTag implements ReturnTree {
jjg@1409:         public final List<DCTree> description;
jjg@1409: 
jjg@1409:         DCReturn(List<DCTree> description) {
jjg@1409:             this.description = description;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.RETURN;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitReturn(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getDescription() {
jjg@1409:             return description;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCSee extends DCBlockTag implements SeeTree {
jjg@1409:         public final List<DCTree> reference;
jjg@1409: 
jjg@1409:         DCSee(List<DCTree> reference) {
jjg@1409:             this.reference = reference;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.SEE;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitSee(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getReference() {
jjg@1409:             return reference;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCSerial extends DCBlockTag implements SerialTree {
jjg@1409:         public final List<DCTree> description;
jjg@1409: 
jjg@1409:         DCSerial(List<DCTree> description) {
jjg@1409:             this.description = description;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.SERIAL;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitSerial(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getDescription() {
jjg@1409:             return description;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCSerialData extends DCBlockTag implements SerialDataTree {
jjg@1409:         public final List<DCTree> description;
jjg@1409: 
jjg@1409:         DCSerialData(List<DCTree> description) {
jjg@1409:             this.description = description;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.SERIAL_DATA;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitSerialData(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getDescription() {
jjg@1409:             return description;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCSerialField extends DCBlockTag implements SerialFieldTree {
jjg@1409:         public final DCIdentifier name;
jjg@1409:         public final DCReference type;
jjg@1409:         public final List<DCTree> description;
jjg@1409: 
jjg@1409:         DCSerialField(DCIdentifier name, DCReference type, List<DCTree> description) {
jjg@1409:             this.description = description;
jjg@1409:             this.name = name;
jjg@1409:             this.type = type;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.SERIAL_FIELD;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitSerialField(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getDescription() {
jjg@1409:             return description;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public IdentifierTree getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public ReferenceTree getType() {
jjg@1409:             return type;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCSince extends DCInlineTag implements SinceTree {
jjg@1409:         public final List<DCTree> body;
jjg@1409: 
jjg@1409:         DCSince(List<DCTree> body) {
jjg@1409:             this.body = body;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.SINCE;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitSince(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getBody() {
jjg@1409:             return body;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCStartElement extends DCTree implements StartElementTree {
jjg@1409:         public final Name name;
jjg@1409:         public final List<DCTree> attrs;
jjg@1409:         public final boolean selfClosing;
jjg@1409: 
jjg@1409:         DCStartElement(Name name, List<DCTree> attrs, boolean selfClosing) {
jjg@1409:             this.name = name;
jjg@1409:             this.attrs = attrs;
jjg@1409:             this.selfClosing = selfClosing;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.START_ELEMENT;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitStartElement(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Name getName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getAttributes() {
jjg@1409:             return attrs;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public boolean isSelfClosing() {
jjg@1409:             return selfClosing;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCText extends DCTree implements TextTree {
jjg@1409:         public final String text;
jjg@1409: 
jjg@1409:         DCText(String text) {
jjg@1409:             this.text = text;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.TEXT;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitText(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public String getBody() {
jjg@1409:             return text;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCThrows extends DCBlockTag implements ThrowsTree {
jjg@1409:         public final Kind kind;
jjg@1409:         public final DCReference name;
jjg@1409:         public final List<DCTree> description;
jjg@1409: 
jjg@1409:         DCThrows(Kind kind, DCReference name, List<DCTree> description) {
jjg@1409:             Assert.check(kind == Kind.EXCEPTION || kind == Kind.THROWS);
jjg@1409:             this.kind = kind;
jjg@1409:             this.name = name;
jjg@1409:             this.description = description;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return kind;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitThrows(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public ReferenceTree getExceptionName() {
jjg@1409:             return name;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getDescription() {
jjg@1409:             return description;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCUnknownBlockTag extends DCBlockTag implements UnknownBlockTagTree {
jjg@1409:         public final Name name;
jjg@1409:         public final List<DCTree> content;
jjg@1409: 
jjg@1409:         DCUnknownBlockTag(Name name, List<DCTree> content) {
jjg@1409:             this.name = name;
jjg@1409:             this.content = content;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.UNKNOWN_BLOCK_TAG;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitUnknownBlockTag(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public String getTagName() {
jjg@1409:             return name.toString();
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getContent() {
jjg@1409:             return content;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCUnknownInlineTag extends DCInlineTag implements UnknownInlineTagTree {
jjg@1409:         public final Name name;
jjg@1409:         public final List<DCTree> content;
jjg@1409: 
jjg@1409:         DCUnknownInlineTag(Name name, List<DCTree> content) {
jjg@1409:             this.name = name;
jjg@1409:             this.content = content;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.UNKNOWN_INLINE_TAG;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitUnknownInlineTag(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public String getTagName() {
jjg@1409:             return name.toString();
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getContent() {
jjg@1409:             return content;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCValue extends DCInlineTag implements ValueTree {
jjg@1409:         public final DCReference ref;
jjg@1409: 
jjg@1409:         DCValue(DCReference ref) {
jjg@1409:             this.ref = ref;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.VALUE;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitValue(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public ReferenceTree getReference() {
jjg@1409:             return ref;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409:     public static class DCVersion extends DCBlockTag implements VersionTree {
jjg@1409:         public final List<DCTree> body;
jjg@1409: 
jjg@1409:         DCVersion(List<DCTree> body) {
jjg@1409:             this.body = body;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public Kind getKind() {
jjg@1409:             return Kind.VERSION;
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public <R, D> R accept(DocTreeVisitor<R, D> v, D d) {
jjg@1409:             return v.visitVersion(this, d);
jjg@1409:         }
jjg@1409: 
jjg@1409:         @Override
jjg@1409:         public List<? extends DocTree> getBody() {
jjg@1409:             return body;
jjg@1409:         }
jjg@1409:     }
jjg@1409: 
jjg@1409: }