Class DocEnv


  • @Deprecated
    public class DocEnv
    extends Object
    Deprecated.
    Holds the environment for a run of javadoc. Holds only the information needed throughout the run and not the compiler info that could be GC'ed or ported.

    This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

    Since:
    1.4
    Author:
    Robert Field, Neal Gafter (rewrite), Scott Seligman (generics)
    • Field Detail

      • docEnvKey

        protected static final com.sun.tools.javac.util.Context.Key<DocEnv> docEnvKey
        Deprecated.
      • showAccess

        protected ModifierFilter showAccess
        Deprecated.
        Access filter (public, protected, ...).
      • legacyDoclet

        protected boolean legacyDoclet
        Deprecated.
        Does the doclet only expect pre-1.5 doclet API?
      • source

        protected com.sun.tools.javac.code.Source source
        Deprecated.
        The source language version.
      • packageMap

        protected Map<com.sun.tools.javac.code.Symbol.PackageSymbol,​PackageDocImpl> packageMap
        Deprecated.
      • classMap

        protected Map<com.sun.tools.javac.code.Symbol.ClassSymbol,​ClassDocImpl> classMap
        Deprecated.
      • fieldMap

        protected Map<com.sun.tools.javac.code.Symbol.VarSymbol,​FieldDocImpl> fieldMap
        Deprecated.
    • Constructor Detail

      • DocEnv

        protected DocEnv​(com.sun.tools.javac.util.Context context)
        Deprecated.
        Constructor
        Parameters:
        context - Context for this javadoc instance.
    • Method Detail

      • instance

        public static DocEnv instance​(com.sun.tools.javac.util.Context context)
        Deprecated.
      • setSilent

        public void setSilent​(boolean silent)
        Deprecated.
      • lookupClass

        public ClassDocImpl lookupClass​(String name)
        Deprecated.
        Look up ClassDoc by qualified name.
      • loadClass

        public ClassDocImpl loadClass​(String name)
        Deprecated.
        Load ClassDoc by qualified name.
      • lookupPackage

        public PackageDocImpl lookupPackage​(String name)
        Deprecated.
        Look up PackageDoc by qualified name.
      • setLocale

        public void setLocale​(String localeName)
        Deprecated.
        Set the locale.
      • shouldDocument

        public boolean shouldDocument​(com.sun.tools.javac.code.Symbol.VarSymbol sym)
        Deprecated.
        Check whether this member should be documented.
      • shouldDocument

        public boolean shouldDocument​(com.sun.tools.javac.code.Symbol.MethodSymbol sym)
        Deprecated.
        Check whether this member should be documented.
      • shouldDocument

        public boolean shouldDocument​(com.sun.tools.javac.code.Symbol.ClassSymbol sym)
        Deprecated.
        check whether this class should be documented.
      • isVisible

        protected boolean isVisible​(com.sun.tools.javac.code.Symbol.ClassSymbol sym)
        Deprecated.
        Check the visibility if this is an nested class. if this is not a nested class, return true. if this is an static visible nested class, return true. if this is an visible nested class if the outer class is visible return true. else return false. IMPORTANT: This also allows, static nested classes to be defined inside an nested class, which is not allowed by the compiler. So such an test case will not reach upto this method itself, but if compiler allows it, then that will go through.
      • printError

        public void printError​(String msg)
        Deprecated.
        Print error message, increment error count.
        Parameters:
        msg - message to print.
      • error

        public void error​(DocImpl doc,
                          String key)
        Deprecated.
        Print error message, increment error count.
        Parameters:
        key - selects message from resource
      • error

        public void error​(SourcePosition pos,
                          String key)
        Deprecated.
        Print error message, increment error count.
        Parameters:
        key - selects message from resource
      • printError

        public void printError​(SourcePosition pos,
                               String msg)
        Deprecated.
        Print error message, increment error count.
        Parameters:
        msg - message to print.
      • error

        public void error​(DocImpl doc,
                          String key,
                          String a1)
        Deprecated.
        Print error message, increment error count.
        Parameters:
        key - selects message from resource
        a1 - first argument
      • error

        public void error​(DocImpl doc,
                          String key,
                          String a1,
                          String a2)
        Deprecated.
        Print error message, increment error count.
        Parameters:
        key - selects message from resource
        a1 - first argument
        a2 - second argument
      • error

        public void error​(DocImpl doc,
                          String key,
                          String a1,
                          String a2,
                          String a3)
        Deprecated.
        Print error message, increment error count.
        Parameters:
        key - selects message from resource
        a1 - first argument
        a2 - second argument
        a3 - third argument
      • printWarning

        public void printWarning​(String msg)
        Deprecated.
        Print warning message, increment warning count.
        Parameters:
        msg - message to print.
      • warning

        public void warning​(DocImpl doc,
                            String key)
        Deprecated.
        Print warning message, increment warning count.
        Parameters:
        key - selects message from resource
      • printWarning

        public void printWarning​(SourcePosition pos,
                                 String msg)
        Deprecated.
        Print warning message, increment warning count.
        Parameters:
        msg - message to print.
      • warning

        public void warning​(DocImpl doc,
                            String key,
                            String a1)
        Deprecated.
        Print warning message, increment warning count.
        Parameters:
        key - selects message from resource
        a1 - first argument
      • warning

        public void warning​(DocImpl doc,
                            String key,
                            String a1,
                            String a2)
        Deprecated.
        Print warning message, increment warning count.
        Parameters:
        key - selects message from resource
        a1 - first argument
        a2 - second argument
      • warning

        public void warning​(DocImpl doc,
                            String key,
                            String a1,
                            String a2,
                            String a3)
        Deprecated.
        Print warning message, increment warning count.
        Parameters:
        key - selects message from resource
        a1 - first argument
        a2 - second argument
        a3 - third argument
      • warning

        public void warning​(DocImpl doc,
                            String key,
                            String a1,
                            String a2,
                            String a3,
                            String a4)
        Deprecated.
        Print warning message, increment warning count.
        Parameters:
        key - selects message from resource
        a1 - first argument
        a2 - second argument
        a3 - third argument
      • printNotice

        public void printNotice​(String msg)
        Deprecated.
        Print a message.
        Parameters:
        msg - message to print.
      • notice

        public void notice​(String key)
        Deprecated.
        Print a message.
        Parameters:
        key - selects message from resource
      • printNotice

        public void printNotice​(SourcePosition pos,
                                String msg)
        Deprecated.
        Print a message.
        Parameters:
        msg - message to print.
      • notice

        public void notice​(String key,
                           String a1)
        Deprecated.
        Print a message.
        Parameters:
        key - selects message from resource
        a1 - first argument
      • notice

        public void notice​(String key,
                           String a1,
                           String a2)
        Deprecated.
        Print a message.
        Parameters:
        key - selects message from resource
        a1 - first argument
        a2 - second argument
      • notice

        public void notice​(String key,
                           String a1,
                           String a2,
                           String a3)
        Deprecated.
        Print a message.
        Parameters:
        key - selects message from resource
        a1 - first argument
        a2 - second argument
        a3 - third argument
      • exit

        public void exit()
        Deprecated.
        Exit, reporting errors and warnings.
      • getPackageDoc

        public PackageDocImpl getPackageDoc​(com.sun.tools.javac.code.Symbol.PackageSymbol pack)
        Deprecated.
        Return the PackageDoc of this package symbol.
      • getClassDoc

        public ClassDocImpl getClassDoc​(com.sun.tools.javac.code.Symbol.ClassSymbol clazz)
        Deprecated.
        Return the ClassDoc (or a subtype) of this class symbol.
      • makeClassDoc

        protected void makeClassDoc​(com.sun.tools.javac.code.Symbol.ClassSymbol clazz,
                                    com.sun.source.util.TreePath treePath)
        Deprecated.
        Create the ClassDoc (or a subtype) for a class symbol.
      • isAnnotationType

        protected static boolean isAnnotationType​(com.sun.tools.javac.code.Symbol.ClassSymbol clazz)
        Deprecated.
      • isAnnotationType

        protected static boolean isAnnotationType​(com.sun.tools.javac.tree.JCTree.JCClassDecl tree)
        Deprecated.
      • getFieldDoc

        public FieldDocImpl getFieldDoc​(com.sun.tools.javac.code.Symbol.VarSymbol var)
        Deprecated.
        Return the FieldDoc of this var symbol.
      • makeFieldDoc

        protected void makeFieldDoc​(com.sun.tools.javac.code.Symbol.VarSymbol var,
                                    com.sun.source.util.TreePath treePath)
        Deprecated.
        Create a FieldDoc for a var symbol.
      • makeMethodDoc

        protected void makeMethodDoc​(com.sun.tools.javac.code.Symbol.MethodSymbol meth,
                                     com.sun.source.util.TreePath treePath)
        Deprecated.
        Create a MethodDoc for this MethodSymbol. Should be called only on symbols representing methods.
      • getMethodDoc

        public MethodDocImpl getMethodDoc​(com.sun.tools.javac.code.Symbol.MethodSymbol meth)
        Deprecated.
        Return the MethodDoc for a MethodSymbol. Should be called only on symbols representing methods.
      • makeConstructorDoc

        protected void makeConstructorDoc​(com.sun.tools.javac.code.Symbol.MethodSymbol meth,
                                          com.sun.source.util.TreePath treePath)
        Deprecated.
        Create the ConstructorDoc for a MethodSymbol. Should be called only on symbols representing constructors.
      • getConstructorDoc

        public ConstructorDocImpl getConstructorDoc​(com.sun.tools.javac.code.Symbol.MethodSymbol meth)
        Deprecated.
        Return the ConstructorDoc for a MethodSymbol. Should be called only on symbols representing constructors.
      • makeAnnotationTypeElementDoc

        protected void makeAnnotationTypeElementDoc​(com.sun.tools.javac.code.Symbol.MethodSymbol meth,
                                                    com.sun.source.util.TreePath treePath)
        Deprecated.
        Create the AnnotationTypeElementDoc for a MethodSymbol. Should be called only on symbols representing annotation type elements.
      • getAnnotationTypeElementDoc

        public AnnotationTypeElementDocImpl getAnnotationTypeElementDoc​(com.sun.tools.javac.code.Symbol.MethodSymbol meth)
        Deprecated.
        Return the AnnotationTypeElementDoc for a MethodSymbol. Should be called only on symbols representing annotation type elements.
      • setEncoding

        public void setEncoding​(String encoding)
        Deprecated.
        Set the encoding.
      • getEncoding

        public String getEncoding()
        Deprecated.
        Get the encoding.