langtools/src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/taglets/ParamTaglet.java
changeset 40303 96a1226aca18
parent 38911 48a00b5ee366
equal deleted inserted replaced
40302:8c0d8d2c3519 40303:96a1226aca18
    32 import javax.lang.model.element.TypeElement;
    32 import javax.lang.model.element.TypeElement;
    33 
    33 
    34 import com.sun.source.doctree.DocTree;
    34 import com.sun.source.doctree.DocTree;
    35 import com.sun.source.doctree.ParamTree;
    35 import com.sun.source.doctree.ParamTree;
    36 import jdk.javadoc.internal.doclets.toolkit.Content;
    36 import jdk.javadoc.internal.doclets.toolkit.Content;
       
    37 import jdk.javadoc.internal.doclets.toolkit.Messages;
    37 import jdk.javadoc.internal.doclets.toolkit.util.CommentHelper;
    38 import jdk.javadoc.internal.doclets.toolkit.util.CommentHelper;
    38 import jdk.javadoc.internal.doclets.toolkit.util.DocFinder;
    39 import jdk.javadoc.internal.doclets.toolkit.util.DocFinder;
    39 import jdk.javadoc.internal.doclets.toolkit.util.DocFinder.Input;
    40 import jdk.javadoc.internal.doclets.toolkit.util.DocFinder.Input;
    40 import jdk.javadoc.internal.doclets.toolkit.util.Utils;
    41 import jdk.javadoc.internal.doclets.toolkit.util.Utils;
    41 
    42 
   286      * @return the Content representation of this <code>Tag</code>.
   287      * @return the Content representation of this <code>Tag</code>.
   287      */
   288      */
   288     private Content processParamTags(Element e, boolean isParams,
   289     private Content processParamTags(Element e, boolean isParams,
   289             List<? extends DocTree> paramTags, Map<String, String> rankMap, TagletWriter writer,
   290             List<? extends DocTree> paramTags, Map<String, String> rankMap, TagletWriter writer,
   290             Set<String> alreadyDocumented) {
   291             Set<String> alreadyDocumented) {
       
   292         Messages messages = writer.configuration().getMessages();
   291         Content result = writer.getOutputInstance();
   293         Content result = writer.getOutputInstance();
   292         if (!paramTags.isEmpty()) {
   294         if (!paramTags.isEmpty()) {
   293             CommentHelper ch = writer.configuration().utils.getCommentHelper(e);
   295             CommentHelper ch = writer.configuration().utils.getCommentHelper(e);
   294             for (DocTree dt : paramTags) {
   296             for (DocTree dt : paramTags) {
   295                 String paramName = isParams
   297                 String paramName = isParams
   296                         ? ch.getParameterName(dt)
   298                         ? ch.getParameterName(dt)
   297                         : "<" + ch.getParameterName(dt) + ">";
   299                         : "<" + ch.getParameterName(dt) + ">";
   298                 if (!rankMap.containsKey(ch.getParameterName(dt))) {
   300                 if (!rankMap.containsKey(ch.getParameterName(dt))) {
   299                     writer.getMsgRetriever().warning(ch.getDocTreePath(dt),
   301                     messages.warning(ch.getDocTreePath(dt),
   300                                                      isParams ?
   302                             isParams
   301                                                      "doclet.Parameters_warn" :
   303                                     ? "doclet.Parameters_warn"
   302                                                      "doclet.Type_Parameters_warn",
   304                                     : "doclet.Type_Parameters_warn",
   303                                                      paramName);
   305                             paramName);
   304                 }
   306                 }
   305                 String rank = rankMap.get(ch.getParameterName(dt));
   307                 String rank = rankMap.get(ch.getParameterName(dt));
   306                 if (rank != null && alreadyDocumented.contains(rank)) {
   308                 if (rank != null && alreadyDocumented.contains(rank)) {
   307                     writer.getMsgRetriever().warning(ch.getDocTreePath(dt),
   309                     messages.warning(ch.getDocTreePath(dt),
   308                                                      isParams ?
   310                             isParams
   309                                                      "doclet.Parameters_dup_warn" :
   311                                     ? "doclet.Parameters_dup_warn"
   310                                                      "doclet.Type_Parameters_dup_warn",
   312                                     : "doclet.Type_Parameters_dup_warn",
   311                                                      paramName);
   313                             paramName);
   312                 }
   314                 }
   313                 result.addContent(processParamTag(e, isParams, writer, dt,
   315                 result.addContent(processParamTag(e, isParams, writer, dt,
   314                                                   ch.getParameterName(dt), alreadyDocumented.isEmpty()));
   316                         ch.getParameterName(dt), alreadyDocumented.isEmpty()));
   315                 alreadyDocumented.add(rank);
   317                 alreadyDocumented.add(rank);
   316             }
   318             }
   317         }
   319         }
   318         return result;
   320         return result;
   319     }
   321     }