src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/util/CommentHelper.java

rev 58344 : records implementation

*** 30,39 ****
--- 30,40 ----
  import java.util.List;
  
  import javax.lang.model.element.Element;
  import javax.lang.model.element.ExecutableElement;
  import javax.lang.model.element.ModuleElement;
+ import javax.lang.model.element.Name;
  import javax.lang.model.element.PackageElement;
  import javax.lang.model.element.TypeElement;
  import javax.lang.model.type.TypeMirror;
  
  import com.sun.source.doctree.AttributeTree;
*** 97,107 ****
          this.dctree = dctree;
      }
  
      public void setOverrideElement(Element ove) {
          if (this.element == ove) {
!             throw new AssertionError("cannot set given element as overriden element");
          }
          overriddenElement = ove;
      }
  
      @SuppressWarnings("fallthrough")
--- 98,108 ----
          this.dctree = dctree;
      }
  
      public void setOverrideElement(Element ove) {
          if (this.element == ove) {
!             throw new AssertionError("cannot set given element as overridden element");
          }
          overriddenElement = ove;
      }
  
      @SuppressWarnings("fallthrough")
*** 145,154 ****
--- 146,158 ----
      }
  
      Element getElement(BaseConfiguration c, ReferenceTree rtree) {
          // likely a synthesized tree
          if (path == null) {
+             // NOTE: this code path only supports module/package/type signatures
+             //       and not member signatures. For more complete support,
+             //       set a suitable path and avoid this branch.
              TypeMirror symbol = c.utils.getSymbol(rtree.getSignature());
              if (symbol == null) {
                  return null;
              }
              return  c.docEnv.getTypeUtils().asElement(symbol);
*** 545,555 ****
  
      public List<? extends DocTree> getTags(BaseConfiguration c, DocTree dtree) {
          return new SimpleDocTreeVisitor<List<? extends DocTree>, Void>() {
              List<? extends DocTree> asList(String content) {
                  List<DocTree> out = new ArrayList<>();
!                 out.add((TextTree)c.cmtUtils.makeTextTree(content));
                  return out;
              }
  
              @Override
              public List<? extends DocTree> visitAuthor(AuthorTree node, Void p) {
--- 549,559 ----
  
      public List<? extends DocTree> getTags(BaseConfiguration c, DocTree dtree) {
          return new SimpleDocTreeVisitor<List<? extends DocTree>, Void>() {
              List<? extends DocTree> asList(String content) {
                  List<DocTree> out = new ArrayList<>();
!                 out.add(c.cmtUtils.makeTextTree(content));
                  return out;
              }
  
              @Override
              public List<? extends DocTree> visitAuthor(AuthorTree node, Void p) {