APIdia Launch Partner
Top Description Inners Fields Constructors Methods
jdk.javadoc.internal.doclint

public Class DocLint

extends DocLint
Class Inheritance
Imports
java.io.File, .IOException, .PrintWriter, java.util.ArrayList, .Collection, .Comparator, .LinkedList, .List, .Queue, javax.lang.model.element.Name, javax.lang.model.util.Elements, .Types, javax.tools.StandardLocation, com.sun.source.doctree.DocCommentTree, com.sun.source.tree.BlockTree, .ClassTree, .CompilationUnitTree, .LambdaExpressionTree, .ModuleTree, .PackageTree, .MethodTree, .Tree, .VariableTree, com.sun.source.util.DocTrees, .JavacTask, .TaskEvent, .TaskListener, .TreePath, .TreePathScanner, com.sun.tools.javac.api.JavacTaskImpl, .JavacTool, com.sun.tools.javac.file.JavacFileManager, com.sun.tools.javac.main.JavaCompiler, com.sun.tools.javac.util.Context, .DefinedBy, .DefinedBy.Api, .StringUtils.DamerauLevenshteinDistance, jdk.javadoc.internal.tool.AccessLevel

Multi-function entry point for the doc check utility. This class can be invoked in the following ways:

Nested and Inner Type Summary

Modifier and TypeClass and Description
public class
pack-priv abstract static class

Field Summary

Modifier and TypeField and Description
pack-priv Checker
pack-priv Env
pack-priv List<File>
pack-priv List<File>
pack-priv List<File>
pack-priv List<String>
pack-priv List<File>
pack-priv boolean
public static final String
private static final String
public static final String
public static final String
public static final String
public static final String

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public String
getName()

Implements com.sun.source.util.Plugin.getName.

Returns the user-friendly name of this plug-in.

public void
init(JavacTask task, String... args)

Implements com.sun.source.util.Plugin.init.

Initializes the plug-in for a given compilation task.

public void
init(JavacTask
the task
task
,
String[]
arguments to configure DocLint
args
,
boolean
whether or not to register a TaskListener to invoke DocLint
addTaskListener
)

Initialize DocLint for use with a JavacTask.

public void
init(DocTrees
the DocTrees utility class
trees
,
Elements
the Elements utility class
elements
,
Types
the Types utility class
types
,
String...
arguments to configure DocLint
args
)

Initialize DocLint with the given utility objects and arguments.

public boolean
public boolean
private String
localize(String code, Object... args)

public static void
main(String... args)

pack-priv void
private void
processArgs(Env env, String... args)

public void
public void
run(String...
Options and operands for doclint
args
)

Simple API entry point.

public void
run(PrintWriter out, String... args)

public void
public boolean
pack-priv void
private static double
pack-priv List<File>
public static List<String>
suggestSimilar(Collection<String> knownTags, String unknownTag)

Inherited from com.sun.tools.doclint.DocLint:
newDocLint

Field Detail

checkerback to summary
pack-priv Checker checker
envback to summary
pack-priv Env env
javacBootClassPathback to summary
pack-priv List<File> javacBootClassPath
javacClassPathback to summary
pack-priv List<File> javacClassPath
javacFilesback to summary
pack-priv List<File> javacFiles
javacOptsback to summary
pack-priv List<String> javacOpts
javacSourcePathback to summary
pack-priv List<File> javacSourcePath
needHelpback to summary
pack-priv boolean needHelp
SEPARATORback to summary
public static final String SEPARATOR
STATSback to summary
private static final String STATS
XCHECK_PACKAGEback to summary
public static final String XCHECK_PACKAGE

Hides com.sun.tools.doclint.DocLint.XCHECK_PACKAGE.

XCUSTOM_TAGS_PREFIXback to summary
public static final String XCUSTOM_TAGS_PREFIX
XMSGS_CUSTOM_PREFIXback to summary
public static final String XMSGS_CUSTOM_PREFIX

Hides com.sun.tools.doclint.DocLint.XMSGS_CUSTOM_PREFIX.

XMSGS_OPTIONback to summary
public static final String XMSGS_OPTION

Hides com.sun.tools.doclint.DocLint.XMSGS_OPTION.

Constructor Detail

DocLintback to summary
public DocLint()

Method Detail

getNameback to summary
public String getName()

Implements com.sun.source.util.Plugin.getName.

Doc from com.sun.source.util.Plugin.getName.

Returns the user-friendly name of this plug-in.

Annotations
@Override
@DefinedBy:COMPILER_TREE
initback to summary
public void init(JavacTask task, String... args)

Implements com.sun.source.util.Plugin.init.

Doc from com.sun.source.util.Plugin.init.

Initializes the plug-in for a given compilation task.

Annotations
@Override
@DefinedBy:COMPILER_TREE
initback to summary
public void init(JavacTask task, String[] args, boolean addTaskListener)

Initialize DocLint for use with a JavacTask. Strict reference checks are not enabled by default.

Parameters
task:JavacTask

the task

args:String[]

arguments to configure DocLint

addTaskListener:boolean

whether or not to register a TaskListener to invoke DocLint

initback to summary
public void init(DocTrees trees, Elements elements, Types types, String... args)

Initialize DocLint with the given utility objects and arguments. Strict reference checks are enabled by default.

Parameters
trees:DocTrees

the DocTrees utility class

elements:Elements

the Elements utility class

types:Types

the Types utility class

args:String[]

arguments to configure DocLint

isGroupEnabledback to summary
public boolean isGroupEnabled(Messages.Group group, AccessLevel accessLevel)
isValidOptionback to summary
public boolean isValidOption(String opt)

Implements abstract com.sun.tools.doclint.DocLint.isValidOption.

localizeback to summary
private String localize(String code, Object... args)
mainback to summary
public static void main(String... args)
processArgsback to summary
pack-priv void processArgs(String... args) throws BadArgs
processArgsback to summary
private void processArgs(Env env, String... args)
reportStatsback to summary
public void reportStats(PrintWriter out)
runback to summary
public void run(String... args) throws BadArgs, IOException

Simple API entry point.

Parameters
args:String[]

Options and operands for doclint

Exceptions
BadArgs:
if an error is detected in any args
IOException:
if there are problems with any of the file arguments
runback to summary
public void run(PrintWriter out, String... args) throws BadArgs, IOException
scanback to summary
public void scan(TreePath p)
shouldCheckback to summary
public boolean shouldCheck(CompilationUnitTree unit)
showHelpback to summary
pack-priv void showHelp(PrintWriter out)
similarityback to summary
private static double similarity(String a, String b)
splitPathback to summary
pack-priv List<File> splitPath(String path)
suggestSimilarback to summary
public static List<String> suggestSimilar(Collection<String> knownTags, String unknownTag)
jdk.javadoc.internal.doclint back to summary

public Class DocLint.BadArgs

extends Exception
Class Inheritance

Field Summary

Modifier and TypeField and Description
pack-priv final transient Object[]
pack-priv final String
private static final long

Constructor Summary

AccessConstructor and Description
pack-priv
BadArgs(String code, Object... args)

Field Detail

argsback to summary
pack-priv final transient Object[] args
codeback to summary
pack-priv final String code
serialVersionUIDback to summary
private static final long serialVersionUID

Hides java.lang.Exception.serialVersionUID.

Constructor Detail

BadArgsback to summary
pack-priv BadArgs(String code, Object... args)
jdk.javadoc.internal.doclint back to summary

pack-priv abstract Class DocLint.DeclScanner

extends TreePathScanner<Void, Void>
Class Inheritance

Field Summary

Modifier and TypeField and Description
pack-priv final Env

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public Void
public Void
public Void
pack-priv abstract void
visitDecl(Tree tree, Name name)

public Void
public Void
public Void
public Void
public Void
Inherited from com.sun.source.util.TreePathScanner:
getCurrentPathscanscan

Field Detail

envback to summary
pack-priv final Env env

Constructor Detail

DeclScannerback to summary
public DeclScanner(Env env)

Method Detail

visitBlockback to summary
public Void visitBlock(BlockTree tree, Void ignore)

Overrides com.sun.source.util.TreeScanner.visitBlock.

Implements com.sun.source.tree.TreeVisitor.visitBlock.

Doc from com.sun.source.util.TreeScanner.visitBlock.

Visits a BlockTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE
visitClassback to summary
public Void visitClass(ClassTree tree, Void ignore)

Overrides com.sun.source.util.TreeScanner.visitClass.

Implements com.sun.source.tree.TreeVisitor.visitClass.

Doc from com.sun.source.util.TreeScanner.visitClass.

Visits a ClassTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE
visitCompilationUnitback to summary
public Void visitCompilationUnit(CompilationUnitTree node, Void p)

Overrides com.sun.source.util.TreeScanner.visitCompilationUnit.

Implements com.sun.source.tree.TreeVisitor.visitCompilationUnit.

Doc from com.sun.source.util.TreeScanner.visitCompilationUnit.

Visits a CompilationUnitTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE
visitDeclback to summary
pack-priv abstract void visitDecl(Tree tree, Name name)
visitLambdaExpressionback to summary
public Void visitLambdaExpression(LambdaExpressionTree tree, Void ignore)

Overrides com.sun.source.util.TreeScanner.visitLambdaExpression.

Implements com.sun.source.tree.TreeVisitor.visitLambdaExpression.

Doc from com.sun.source.util.TreeScanner.visitLambdaExpression.

Visits a LambdaExpressionTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE
visitMethodback to summary
public Void visitMethod(MethodTree tree, Void ignore)

Overrides com.sun.source.util.TreeScanner.visitMethod.

Implements com.sun.source.tree.TreeVisitor.visitMethod.

Doc from com.sun.source.util.TreeScanner.visitMethod.

Visits a MethodTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE
visitModuleback to summary
public Void visitModule(ModuleTree tree, Void ignore)

Overrides com.sun.source.util.TreeScanner.visitModule.

Implements com.sun.source.tree.TreeVisitor.visitModule.

Doc from com.sun.source.util.TreeScanner.visitModule.

Visits a ModuleTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE
visitPackageback to summary
public Void visitPackage(PackageTree tree, Void ignore)

Overrides com.sun.source.util.TreeScanner.visitPackage.

Implements com.sun.source.tree.TreeVisitor.visitPackage.

Doc from com.sun.source.util.TreeScanner.visitPackage.

Visits a PackageTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE
visitVariableback to summary
public Void visitVariable(VariableTree tree, Void ignore)

Overrides com.sun.source.util.TreeScanner.visitVariable.

Implements com.sun.source.tree.TreeVisitor.visitVariable.

Doc from com.sun.source.util.TreeScanner.visitVariable.

Visits a VariableTree node.

Annotations
@Override
@DefinedBy:COMPILER_TREE