jdk-sandbox: comparison langtools/src/jdk.compiler/share/classes/com/sun/tools/doclint/Checker.java

equal deleted inserted replaced

-:46aacfffd3b5
+:2d24bda701dc
 import com.sun.source.util.DocTreePath;
 import com.sun.source.util.DocTreePathScanner;
 import com.sun.source.util.TreePath;
 import com.sun.tools.doclint.HtmlTag.AttrKind;
 import com.sun.tools.javac.tree.DocPretty;
+import com.sun.tools.javac.util.DefinedBy;
+import com.sun.tools.javac.util.DefinedBy.Api;
 import com.sun.tools.javac.util.StringUtils;
 import static com.sun.tools.doclint.Messages.Group.*;
 /**
 private void reportReference(String code, Object... args) {
 env.messages.report(REFERENCE, Kind.WARNING, env.currPath.getLeaf(), code, args);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitDocComment(DocCommentTree tree, Void ignore) {
 super.visitDocComment(tree, ignore);
 for (TagStackItem tsi: tagStack) {
 warnIfEmpty(tsi, null);
 if (tsi.tree.getKind() == DocTree.Kind.START_ELEMENT
 }
 // </editor-fold>
 // <editor-fold defaultstate="collapsed" desc="Text and entities.">
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitText(TextTree tree, Void ignore) {
 if (hasNonWhitespace(tree)) {
 checkAllowsText(tree);
 markEnclosingTag(Flag.HAS_TEXT);
 }
 return null;
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitEntity(EntityTree tree, Void ignore) {
 checkAllowsText(tree);
 markEnclosingTag(Flag.HAS_TEXT);
 String name = tree.getName().toString();
 if (name.startsWith("#")) {
 // </editor-fold>
 // <editor-fold defaultstate="collapsed" desc="HTML elements">
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitStartElement(StartElementTree tree, Void ignore) {
 final Name treeName = tree.getName();
 final HtmlTag t = HtmlTag.get(treeName);
 if (t == null) {
 env.messages.error(HTML, tree, "dc.tag.unknown", treeName);
 case H6: return 6;
 default: throw new IllegalArgumentException();
 }
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitEndElement(EndElementTree tree, Void ignore) {
 final Name treeName = tree.getName();
 final HtmlTag t = HtmlTag.get(treeName);
 if (t == null) {
 env.messages.error(HTML, tree, "dc.tag.unknown", treeName);
 // </editor-fold>
 // <editor-fold defaultstate="collapsed" desc="HTML attributes">
-@Override @SuppressWarnings("fallthrough")
+@Override @DefinedBy(Api.COMPILER_TREE) @SuppressWarnings("fallthrough")
 public Void visitAttribute(AttributeTree tree, Void ignore) {
 HtmlTag currTag = tagStack.peek().tag;
 if (currTag != null) {
 Name name = tree.getName();
 HtmlTag.Attr attr = currTag.getAttr(name);
 }
 // </editor-fold>
 // <editor-fold defaultstate="collapsed" desc="javadoc tags">
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitAuthor(AuthorTree tree, Void ignore) {
 warnIfEmpty(tree, tree.getName());
 return super.visitAuthor(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitDocRoot(DocRootTree tree, Void ignore) {
 markEnclosingTag(Flag.HAS_INLINE_TAG);
 return super.visitDocRoot(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitInheritDoc(InheritDocTree tree, Void ignore) {
 markEnclosingTag(Flag.HAS_INLINE_TAG);
 // TODO: verify on overridden method
 foundInheritDoc = true;
 return super.visitInheritDoc(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitLink(LinkTree tree, Void ignore) {
 markEnclosingTag(Flag.HAS_INLINE_TAG);
 // simulate inline context on tag stack
 HtmlTag t = (tree.getKind() == DocTree.Kind.LINK)
 ? HtmlTag.CODE : HtmlTag.SPAN;
 } finally {
 tagStack.pop();
 }
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitLiteral(LiteralTree tree, Void ignore) {
 markEnclosingTag(Flag.HAS_INLINE_TAG);
 if (tree.getKind() == DocTree.Kind.CODE) {
 for (TagStackItem tsi: tagStack) {
 if (tsi.tag == HtmlTag.CODE) {
 }
 }
 return super.visitLiteral(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 @SuppressWarnings("fallthrough")
 public Void visitParam(ParamTree tree, Void ignore) {
 boolean typaram = tree.isTypeParameter();
 IdentifierTree nameTree = tree.getName();
 Element paramElement = nameTree != null ? env.trees.getElement(new DocTreePath(getCurrentPath(), nameTree)) : null;
 reportMissing("dc.missing.param", paramName);
 }
 }
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitReference(ReferenceTree tree, Void ignore) {
 String sig = tree.getSignature();
 if (sig.contains("<") || sig.contains(">"))
 env.messages.error(REFERENCE, tree, "dc.type.arg.not.allowed");
 if (e == null)
 env.messages.error(REFERENCE, tree, "dc.ref.not.found");
 return super.visitReference(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitReturn(ReturnTree tree, Void ignore) {
 Element e = env.trees.getElement(env.currPath);
 if (e.getKind() != ElementKind.METHOD
 || ((ExecutableElement) e).getReturnType().getKind() == TypeKind.VOID)
 env.messages.error(REFERENCE, tree, "dc.invalid.return");
 foundReturn = true;
 warnIfEmpty(tree, tree.getDescription());
 return super.visitReturn(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitSerialData(SerialDataTree tree, Void ignore) {
 warnIfEmpty(tree, tree.getDescription());
 return super.visitSerialData(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitSerialField(SerialFieldTree tree, Void ignore) {
 warnIfEmpty(tree, tree.getDescription());
 return super.visitSerialField(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitSince(SinceTree tree, Void ignore) {
 warnIfEmpty(tree, tree.getBody());
 return super.visitSince(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitThrows(ThrowsTree tree, Void ignore) {
 ReferenceTree exName = tree.getExceptionName();
 Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
 if (ex == null) {
 env.messages.error(REFERENCE, tree, "dc.ref.not.found");
 if (isCheckedException(tl) && !foundThrows.contains(tl))
 reportMissing("dc.missing.throws", tl);
 }
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitUnknownBlockTag(UnknownBlockTagTree tree, Void ignore) {
 checkUnknownTag(tree, tree.getTagName());
 return super.visitUnknownBlockTag(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitUnknownInlineTag(UnknownInlineTagTree tree, Void ignore) {
 checkUnknownTag(tree, tree.getTagName());
 return super.visitUnknownInlineTag(tree, ignore);
 }
 private void checkUnknownTag(DocTree tree, String tagName) {
 if (env.customTags != null && !env.customTags.contains(tagName))
 env.messages.error(SYNTAX, tree, "dc.tag.unknown", tagName);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitValue(ValueTree tree, Void ignore) {
 ReferenceTree ref = tree.getReference();
 if (ref == null || ref.getSignature().isEmpty()) {
 if (!isConstant(env.currElement))
 env.messages.error(REFERENCE, tree, "dc.value.not.allowed.here");
 default:
 return false;
 }
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitVersion(VersionTree tree, Void ignore) {
 warnIfEmpty(tree, tree.getBody());
 return super.visitVersion(tree, ignore);
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Void visitErroneous(ErroneousTree tree, Void ignore) {
 env.messages.error(SYNTAX, tree, null, tree.getDiagnostic().getMessage(null));
 return null;
 }
 // </editor-fold>

changeset 26266	2d24bda701dc
parent 25874	83c19f00452c
child 29291	076c277565f7