jdk8-mips64-public/langtools: src/share/classes/com/sun/tools/doclets/internal/toolkit/taglets/TagletManager.java@24a47c3062fe (annotated)

src/share/classes/com/sun/tools/doclets/internal/toolkit/taglets/TagletManager.java@24a47c3062fe (annotated)

src/share/classes/com/sun/tools/doclets/internal/toolkit/taglets/TagletManager.java

Thu, 02 Oct 2008 19:58:40 -0700

author: xdono
date: Thu, 02 Oct 2008 19:58:40 -0700
changeset 117: 24a47c3062fe
parent 74: 5a9172b251dd
child 184: 905e151a185a
permissions: -rw-r--r--

6754988: Update copyright year
Summary: Update for files that have been modified starting July 2008
Reviewed-by: ohair, tbell

 /*
  * Copyright 2001-2008 Sun Microsystems, Inc.  All Rights Reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Sun designates this
  * particular file as subject to the "Classpath" exception as provided
  * by Sun in the LICENSE file that accompanied this code.
  *
  * This code is distributed in the hope that it will be useful, but WITHOUT
  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  * version 2 for more details (a copy is included in the LICENSE file that
  * accompanied this code).
  *
  * You should have received a copy of the GNU General Public License version
  * 2 along with this work; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  *
  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  * CA 95054 USA or visit www.sun.com if you need additional information or
  * have any questions.
  */
 package com.sun.tools.doclets.internal.toolkit.taglets;
 import com.sun.javadoc.*;
 import com.sun.tools.doclets.internal.toolkit.util.*;
 import java.io.*;
 import java.lang.reflect.*;
 import java.net.*;
 import java.util.*;
 /**
  * Manages the<code>Taglet</code>s used by doclets.
  *
  * This code is not part of an API.
  * It is implementation that is subject to change.
  * Do not use it as an API
  *
  * @author Jamie Ho
  * @since 1.4
  */
 public class TagletManager {
     /**
      * The default seperator for the simple tag option.
      */
     public static final char SIMPLE_TAGLET_OPT_SEPERATOR = ':';
     /**
      * The alternate seperator for simple tag options.  Use this
      * with you want the default seperator to be in the name of the
      * custom tag.
      */
     public static final String ALT_SIMPLE_TAGLET_OPT_SEPERATOR = "-";
     /**
      * The map of custom tags.
      */
     private LinkedHashMap<String,Taglet> customTags;
     /**
      * The array of custom tags that can appear in packages.
      */
     private Taglet[] packageTags;
     /**
      * The array of custom tags that can appear in classes or interfaces.
      */
     private Taglet[] typeTags;
     /**
      * The array of custom tags that can appear in fields.
      */
     private Taglet[] fieldTags;
     /**
      * The array of custom tags that can appear in constructors.
      */
     private Taglet[] constructorTags;
     /**
      * The array of custom tags that can appear in methods.
      */
     private Taglet[] methodTags;
     /**
      * The array of custom tags that can appear in the overview.
      */
     private Taglet[] overviewTags;
     /**
      * The array of custom tags that can appear in comments.
      */
     private Taglet[] inlineTags;
     /**
      * The array of custom tags that can appear in the serialized form.
      */
     private Taglet[] serializedFormTags;
     /**
      * The message retriever that will be used to print error messages.
      */
     private MessageRetriever message;
     /**
      * Keep track of standard tags.
      */
     private Set<String> standardTags;
     /**
      * Keep track of standard tags in lowercase to compare for better
      * error messages when a tag like @docRoot is mistakenly spelled
      * lowercase @docroot.
      */
     private Set<String> standardTagsLowercase;
     /**
      * Keep track of overriden standard tags.
      */
     private Set<String> overridenStandardTags;
     /**
      * Keep track of the tags that may conflict
      * with standard tags in the future (any custom tag without
      * a period in its name).
      */
     private Set<String> potentiallyConflictingTags;
     /**
      * The set of unseen custom tags.
      */
     private Set<String> unseenCustomTags;
     /**
      * True if we do not want to use @since tags.
      */
     private boolean nosince;
     /**
      * True if we want to use @version tags.
      */
     private boolean showversion;
     /**
      * True if we want to use @author tags.
      */
     private boolean showauthor;
     /**
      * Construct a new <code>TagletManager</code>.
      * @param nosince true if we do not want to use @since tags.
      * @param showversion true if we want to use @version tags.
      * @param showauthor true if we want to use @author tags.
      * @param message the message retriever to print warnings.
      */
     public TagletManager(boolean nosince, boolean showversion,
                          boolean showauthor, MessageRetriever message){
         overridenStandardTags = new HashSet<String>();
         potentiallyConflictingTags = new HashSet<String>();
         standardTags = new HashSet<String>();
         standardTagsLowercase = new HashSet<String>();
         unseenCustomTags = new HashSet<String>();
         customTags = new LinkedHashMap<String,Taglet>();
         this.nosince = nosince;
         this.showversion = showversion;
         this.showauthor = showauthor;
         this.message = message;
         initStandardTags();
         initStandardTagsLowercase();
     }
     /**
      * Add a new <code>CustomTag</code>.  This is used to add a Taglet from within
      * a Doclet.  No message is printed to indicate that the Taglet is properly
      * registered because these Taglets are typically added for every execution of the
      * Doclet.  We don't want to see this type of error message every time.
      * @param customTag the new <code>CustomTag</code> to add.
      */
     public void addCustomTag(Taglet customTag) {
         if (customTag != null) {
             String name = customTag.getName();
             if (customTags.containsKey(name)) {
                 customTags.remove(name);
             }
             customTags.put(name, customTag);
             checkTagName(name);
         }
     }
     /**
      * Add a new <code>Taglet</code>.  Print a message to indicate whether or not
      * the Taglet was registered properly.
      * @param classname  the name of the class representing the custom tag.
      * @param tagletPath  the path to the class representing the custom tag.
      */
     public void addCustomTag(String classname, String tagletPath) {
         try {
             Class<?> customTagClass = null;
             // construct class loader
             String cpString = null;   // make sure env.class.path defaults to dot
             // do prepends to get correct ordering
             cpString = appendPath(System.getProperty("env.class.path"), cpString);
             cpString = appendPath(System.getProperty("java.class.path"), cpString);
             cpString = appendPath(tagletPath, cpString);
             URLClassLoader appClassLoader = new URLClassLoader(pathToURLs(cpString));
             customTagClass = appClassLoader.loadClass(classname);
             Method meth = customTagClass.getMethod("register",
                                                    new Class[] {Class.forName("java.util.Map")});
             Object[] list = customTags.values().toArray();
             Taglet lastTag = (list != null && list.length > 0)
                 ? (Taglet) list[list.length-1] : null;
             meth.invoke(null, new Object[] {customTags});
             list = customTags.values().toArray();
             Object newLastTag = (list != null&& list.length > 0)
                 ? list[list.length-1] : null;
             if (lastTag != newLastTag) {
                 //New taglets must always be added to the end of the LinkedHashMap.
                 //If the current and previous last taglet are not equal, that
                 //means a new Taglet has been added.
                 message.notice("doclet.Notice_taglet_registered", classname);
                 if (newLastTag != null) {
                     checkTaglet(newLastTag);
                 }
             }
         } catch (Exception exc) {
             message.error("doclet.Error_taglet_not_registered", exc.getClass().getName(), classname);
         }
     }
     private String appendPath(String path1, String path2) {
         if (path1 == null || path1.length() == 0) {
             return path2 == null ? "." : path2;
         } else if (path2 == null || path2.length() == 0) {
             return path1;
         } else {
             return path1  + File.pathSeparator + path2;
         }
     }
     /**
      * Utility method for converting a search path string to an array
      * of directory and JAR file URLs.
      *
      * @param path the search path string
      * @return the resulting array of directory and JAR file URLs
      */
     private static URL[] pathToURLs(String path) {
         StringTokenizer st = new StringTokenizer(path, File.pathSeparator);
         URL[] urls = new URL[st.countTokens()];
         int count = 0;
         while (st.hasMoreTokens()) {
             URL url = fileToURL(new File(st.nextToken()));
             if (url != null) {
                 urls[count++] = url;
             }
         }
         if (urls.length != count) {
             URL[] tmp = new URL[count];
             System.arraycopy(urls, 0, tmp, 0, count);
             urls = tmp;
         }
         return urls;
     }
     /**
      * Returns the directory or JAR file URL corresponding to the specified
      * local file name.
      *
      * @param file the File object
      * @return the resulting directory or JAR file URL, or null if unknown
      */
     private static URL fileToURL(File file) {
         String name;
         try {
             name = file.getCanonicalPath();
         } catch (IOException e) {
             name = file.getAbsolutePath();
         }
         name = name.replace(File.separatorChar, '/');
         if (!name.startsWith("/")) {
             name = "/" + name;
         }
         // If the file does not exist, then assume that it's a directory
         if (!file.isFile()) {
             name = name + "/";
         }
         try {
             return new URL("file", "", name);
         } catch (MalformedURLException e) {
             throw new IllegalArgumentException("file");
         }
     }
     /**
      * Add a new <code>SimpleTaglet</code>.  If this tag already exists
      * and the header passed as an argument is null, move tag to the back of the
      * list. If this tag already exists and the header passed as an argument is
      * not null, overwrite previous tag with new one.  Otherwise, add new
      * SimpleTaglet to list.
      * @param tagName the name of this tag
      * @param header the header to output.
      * @param locations the possible locations that this tag
      * can appear in.
      */
     public void addNewSimpleCustomTag(String tagName, String header, String locations) {
         if (tagName == null || locations == null) {
             return;
         }
         Taglet tag = customTags.get(tagName);
         locations = locations.toLowerCase();
         if (tag == null || header != null) {
             customTags.remove(tagName);
             customTags.put(tagName, new SimpleTaglet(tagName, header, locations));
             if (locations != null && locations.indexOf('x') == -1) {
                 checkTagName(tagName);
             }
         } else {
             //Move to back
             customTags.remove(tagName);
             customTags.put(tagName, tag);
         }
     }
     /**
      * Given a tag name, add it to the set of tags it belongs to.
      */
     private void checkTagName(String name) {
         if (standardTags.contains(name)) {
             overridenStandardTags.add(name);
         } else {
             if (name.indexOf('.') == -1) {
                 potentiallyConflictingTags.add(name);
             }
             unseenCustomTags.add(name);
         }
     }
     /**
      * Check the taglet to see if it is a legacy taglet.  Also
      * check its name for errors.
      */
     private void checkTaglet(Object taglet) {
         if (taglet instanceof Taglet) {
             checkTagName(((Taglet) taglet).getName());
         } else if (taglet instanceof com.sun.tools.doclets.Taglet) {
             com.sun.tools.doclets.Taglet legacyTaglet = (com.sun.tools.doclets.Taglet) taglet;
             customTags.remove(legacyTaglet.getName());
             customTags.put(legacyTaglet.getName(), new LegacyTaglet(legacyTaglet));
             checkTagName(legacyTaglet.getName());
         } else {
             throw new IllegalArgumentException("Given object is not a taglet.");
         }
     }
     /**
      * Given a name of a seen custom tag, remove it from the set of unseen
      * custom tags.
      * @param name the name of the seen custom tag.
      */
     public void seenCustomTag(String name) {
         unseenCustomTags.remove(name);
     }
     /**
      * Given an array of <code>Tag</code>s, check for spelling mistakes.
      * @param doc the Doc object that holds the tags.
      * @param tags the list of <code>Tag</code>s to check.
      * @param areInlineTags true if the array of tags are inline and false otherwise.
      */
     public void checkTags(Doc doc, Tag[] tags, boolean areInlineTags) {
         if (tags == null) {
             return;
         }
         Taglet taglet;
         for (int i = 0; i < tags.length; i++) {
             String name = tags[i].name();
             if (name.length() > 0 && name.charAt(0) == '@') {
                 name = name.substring(1, name.length());
             }
             if (! (standardTags.contains(name) || customTags.containsKey(name))) {
                 if (standardTagsLowercase.contains(name.toLowerCase())) {
                     message.warning(tags[i].position(), "doclet.UnknownTagLowercase", tags[i].name());
                     continue;
                 } else {
                     message.warning(tags[i].position(), "doclet.UnknownTag", tags[i].name());
                     continue;
                 }
             }
             //Check if this tag is being used in the wrong location.
             if ((taglet = customTags.get(name)) != null) {
                 if (areInlineTags && ! taglet.isInlineTag()) {
                     printTagMisuseWarn(taglet, tags[i], "inline");
                 }
                 if ((doc instanceof RootDoc) && ! taglet.inOverview()) {
                     printTagMisuseWarn(taglet, tags[i], "overview");
                 } else if ((doc instanceof PackageDoc) && ! taglet.inPackage()) {
                     printTagMisuseWarn(taglet, tags[i], "package");
                 } else if ((doc instanceof ClassDoc) && ! taglet.inType()) {
                     printTagMisuseWarn(taglet, tags[i], "class");
                 } else if ((doc instanceof ConstructorDoc) && ! taglet.inConstructor()) {
                     printTagMisuseWarn(taglet, tags[i], "constructor");
                 } else if ((doc instanceof FieldDoc) && ! taglet.inField()) {
                     printTagMisuseWarn(taglet, tags[i], "field");
                 } else if ((doc instanceof MethodDoc) && ! taglet.inMethod()) {
                     printTagMisuseWarn(taglet, tags[i], "method");
                 }
             }
         }
     }
     /**
      * Given the taglet, the tag and the type of documentation that the tag
      * was found in, print a tag misuse warning.
      * @param taglet the taglet representing the misused tag.
      * @param tag the misused tag.
      * @param holderType the type of documentation that the misused tag was found in.
      */
     private void printTagMisuseWarn(Taglet taglet, Tag tag, String holderType) {
         Set<String> locationsSet = new LinkedHashSet<String>();
         if (taglet.inOverview()) {
             locationsSet.add("overview");
         }
         if (taglet.inPackage()) {
             locationsSet.add("package");
         }
         if (taglet.inType()) {
             locationsSet.add("class/interface");
         }
         if (taglet.inConstructor())  {
             locationsSet.add("constructor");
         }
         if (taglet.inField()) {
             locationsSet.add("field");
         }
         if (taglet.inMethod()) {
             locationsSet.add("method");
         }
         if (taglet.isInlineTag()) {
             locationsSet.add("inline text");
         }
         String[] locations = locationsSet.toArray(new String[]{});
         if (locations == null || locations.length == 0) {
             //This known tag is excluded.
             return;
         }
         StringBuffer combined_locations = new StringBuffer();
         for (int i = 0; i < locations.length; i++) {
             if (i > 0) {
                 combined_locations.append(", ");
             }
             combined_locations.append(locations[i]);
         }
         message.warning(tag.position(), "doclet.tag_misuse",
             "@" + taglet.getName(), holderType, combined_locations.toString());
     }
     /**
      * Return the array of <code>Taglet</code>s that can
      * appear in packages.
      * @return the array of <code>Taglet</code>s that can
      * appear in packages.
      */
     public Taglet[] getPackageCustomTags() {
         if (packageTags == null) {
             initCustomTagArrays();
         }
         return packageTags;
     }
     /**
      * Return the array of <code>Taglet</code>s that can
      * appear in classes or interfaces.
      * @return the array of <code>Taglet</code>s that can
      * appear in classes or interfaces.
      */
     public Taglet[] getTypeCustomTags() {
         if (typeTags == null) {
             initCustomTagArrays();
         }
         return typeTags;
     }
     /**
      * Return the array of inline <code>Taglet</code>s that can
      * appear in comments.
      * @return the array of <code>Taglet</code>s that can
      * appear in comments.
      */
     public Taglet[] getInlineCustomTags() {
         if (inlineTags == null) {
             initCustomTagArrays();
         }
         return inlineTags;
     }
     /**
      * Return the array of <code>Taglet</code>s that can
      * appear in fields.
      * @return the array of <code>Taglet</code>s that can
      * appear in field.
      */
     public Taglet[] getFieldCustomTags() {
         if (fieldTags == null) {
             initCustomTagArrays();
         }
         return fieldTags;
     }
     /**
      * Return the array of <code>Taglet</code>s that can
      * appear in the serialized form.
      * @return the array of <code>Taglet</code>s that can
      * appear in the serialized form.
      */
     public Taglet[] getSerializedFormTags() {
         if (serializedFormTags == null) {
             initCustomTagArrays();
         }
         return serializedFormTags;
     }
     /**
      * @return the array of <code>Taglet</code>s that can
      * appear in the given Doc.
      */
     public Taglet[] getCustomTags(Doc doc) {
         if (doc instanceof ConstructorDoc) {
             return getConstructorCustomTags();
         } else if (doc instanceof MethodDoc) {
             return getMethodCustomTags();
         } else if (doc instanceof FieldDoc) {
             return getFieldCustomTags();
         } else if (doc instanceof ClassDoc) {
             return getTypeCustomTags();
         } else if (doc instanceof PackageDoc) {
             return getPackageCustomTags();
         } else if (doc instanceof RootDoc) {
             return getOverviewCustomTags();
         }
         return null;
     }
     /**
      * Return the array of <code>Taglet</code>s that can
      * appear in constructors.
      * @return the array of <code>Taglet</code>s that can
      * appear in constructors.
      */
     public Taglet[] getConstructorCustomTags() {
         if (constructorTags == null) {
             initCustomTagArrays();
         }
         return constructorTags;
     }
     /**
      * Return the array of <code>Taglet</code>s that can
      * appear in methods.
      * @return the array of <code>Taglet</code>s that can
      * appear in methods.
      */
     public Taglet[] getMethodCustomTags() {
         if (methodTags == null) {
             initCustomTagArrays();
         }
         return methodTags;
     }
     /**
      * Return the array of <code>Taglet</code>s that can
      * appear in an overview.
      * @return the array of <code>Taglet</code>s that can
      * appear in overview.
      */
     public Taglet[] getOverviewCustomTags() {
         if (overviewTags == null) {
             initCustomTagArrays();
         }
         return overviewTags;
     }
     /**
      * Initialize the custom tag arrays.
      */
     private void initCustomTagArrays() {
         Iterator<Taglet> it = customTags.values().iterator();
         ArrayList<Taglet> pTags = new ArrayList<Taglet>(customTags.size());
         ArrayList<Taglet> tTags = new ArrayList<Taglet>(customTags.size());
         ArrayList<Taglet> fTags = new ArrayList<Taglet>(customTags.size());
         ArrayList<Taglet> cTags = new ArrayList<Taglet>(customTags.size());
         ArrayList<Taglet> mTags = new ArrayList<Taglet>(customTags.size());
         ArrayList<Taglet> iTags = new ArrayList<Taglet>(customTags.size());
         ArrayList<Taglet> oTags = new ArrayList<Taglet>(customTags.size());
         Taglet current;
         while (it.hasNext()) {
             current = it.next();
             if (current.inPackage() && !current.isInlineTag()) {
                 pTags.add(current);
             }
             if (current.inType() && !current.isInlineTag()) {
                 tTags.add(current);
             }
             if (current.inField() && !current.isInlineTag()) {
                 fTags.add(current);
             }
             if (current.inConstructor() && !current.isInlineTag()) {
                 cTags.add(current);
             }
             if (current.inMethod() && !current.isInlineTag()) {
                 mTags.add(current);
             }
             if (current.isInlineTag()) {
                 iTags.add(current);
             }
             if (current.inOverview() && !current.isInlineTag()) {
                 oTags.add(current);
             }
         }
         packageTags = pTags.toArray(new Taglet[] {});
         typeTags = tTags.toArray(new Taglet[] {});
         fieldTags = fTags.toArray(new Taglet[] {});
         constructorTags = cTags.toArray(new Taglet[] {});
         methodTags = mTags.toArray(new Taglet[] {});
         overviewTags = oTags.toArray(new Taglet[] {});
         inlineTags = iTags.toArray(new Taglet[] {});
         //Init the serialized form tags
         serializedFormTags = new Taglet[4];
         serializedFormTags[0] = customTags.get("serialData");
         serializedFormTags[1] = customTags.get("throws");
         serializedFormTags[2] = customTags.get("since");
         serializedFormTags[3] = customTags.get("see");
     }
     /**
      * Initialize standard Javadoc tags for ordering purposes.
      */
     private void initStandardTags() {
         Taglet temp;
         customTags.put((temp = new ParamTaglet()).getName(), temp);
         customTags.put((temp = new ReturnTaglet()).getName(), temp);
         customTags.put((temp = new ThrowsTaglet()).getName(), temp);
         customTags.put((temp = new SimpleTaglet("exception",
             null, SimpleTaglet.METHOD + SimpleTaglet.CONSTRUCTOR)).getName(), temp);
         if (!nosince) {
             customTags.put((temp = new SimpleTaglet("since", message.getText("doclet.Since"),
                SimpleTaglet.ALL)).getName(), temp);
         }
         if (showversion) {
             customTags.put((temp = new SimpleTaglet("version", message.getText("doclet.Version"),
                 SimpleTaglet.PACKAGE + SimpleTaglet.TYPE + SimpleTaglet.OVERVIEW)).getName(), temp);
         }
         if (showauthor) {
             customTags.put((temp = new SimpleTaglet("author", message.getText("doclet.Author"),
                 SimpleTaglet.PACKAGE + SimpleTaglet.TYPE + SimpleTaglet.OVERVIEW)).getName(), temp);
         }
         customTags.put((temp = new SimpleTaglet("serialData", message.getText("doclet.SerialData"),
             SimpleTaglet.EXCLUDED)).getName(), temp);
         customTags.put((temp = new SimpleTaglet("factory", message.getText("doclet.Factory"),
             SimpleTaglet.METHOD)).getName(), temp);
         customTags.put((temp = new SeeTaglet()).getName(), temp);
         //Standard inline tags
         customTags.put((temp = new DocRootTaglet()).getName(), temp);
         customTags.put((temp = new InheritDocTaglet()).getName(), temp);
         customTags.put((temp = new ValueTaglet()).getName(), temp);
         customTags.put((temp = new LegacyTaglet(new LiteralTaglet())).getName(),
             temp);
         customTags.put((temp = new LegacyTaglet(new CodeTaglet())).getName(),
             temp);
         //Keep track of the names of standard tags for error
         //checking purposes.
         standardTags.add("param");
         standardTags.add("return");
         standardTags.add("throws");
         standardTags.add("exception");
         standardTags.add("since");
         standardTags.add("version");
         standardTags.add("author");
         standardTags.add("see");
         standardTags.add("deprecated");
         standardTags.add("link");
         standardTags.add("linkplain");
         standardTags.add("inheritDoc");
         standardTags.add("docRoot");
         standardTags.add("value");
         standardTags.add("serial");
         standardTags.add("serialData");
         standardTags.add("serialField");
         standardTags.add("Text");
         standardTags.add("literal");
         standardTags.add("code");
     }
     /**
      * Initialize lowercase version of standard Javadoc tags.
      */
     private void initStandardTagsLowercase() {
         Iterator it = standardTags.iterator();
         while (it.hasNext()) {
             standardTagsLowercase.add(((String)it.next()).toLowerCase());
         }
     }
     public boolean isKnownCustomTag(String tagName) {
         return customTags.containsKey(tagName);
     }
     /**
      * Print a list of {@link Taglet}s that might conflict with
      * standard tags in the future and a list of standard tags
      * that have been overriden.
      */
     public void printReport() {
         printReportHelper("doclet.Notice_taglet_conflict_warn", potentiallyConflictingTags);
         printReportHelper("doclet.Notice_taglet_overriden", overridenStandardTags);
         printReportHelper("doclet.Notice_taglet_unseen", unseenCustomTags);
     }
     private void printReportHelper(String noticeKey, Set<String> names) {
         if (names.size() > 0) {
             String[] namesArray = names.toArray(new String[] {});
             String result = " ";
             for (int i = 0; i < namesArray.length; i++) {
                 result += "@" + namesArray[i];
                 if (i + 1 < namesArray.length) {
                     result += ", ";
                 }
             }
             message.notice(noticeKey, result);
         }
     }
     /**
      * Given the name of a tag, return the corresponding taglet.
      * Return null if the tag is unknown.
      *
      * @param name the name of the taglet to retrieve.
      * @return return the corresponding taglet. Return null if the tag is
      *         unknown.
      */
     public Taglet getTaglet(String name) {
         if (name.indexOf("@") == 0) {
             return customTags.get(name.substring(1));
         } else {
             return customTags.get(name);
         }
     }
 }

Mercurial > jdk8-mips64-public > langtools / annotate

src/share/classes/com/sun/tools/doclets/internal/toolkit/taglets/TagletManager.java@24a47c3062fe (annotated)

src/share/classes/com/sun/tools/doclets/internal/toolkit/taglets/TagletManager.java