Class StandardDoclet

java.lang.Object
jdk.javadoc.doclet.StandardDoclet
All Implemented Interfaces:
Doclet
public class StandardDoclet extends Object implements Doclet
This doclet generates HTML-formatted documentation for the specified modules, packages and types. It is the doclet that is used by the javadoc tool and the system documentation tool when no other doclet is specified to be used.

User-Defined Taglets

The standard doclet supports user-defined taglets, which can be used to generate customized output for user-defined tags in documentation comments. Taglets invoked by the standard doclet must return strings from Taglet.toString as follows:
Inline Tags
The returned string must be flow content, or any valid fragment of HTML code that may appear in the body of a document. There may be additional constraints, depending on how the tag is to be used in a documentation comment: for example, if the tag may be used within an inline element such as <b> or <i>, the taglet must not return a string containing block tags, like <h3> or <p>.
Block Tags
The returned string must be suitable content for a definition list, or <dl> element. It will typically be a series of pairs of <dt> and <dd> elements.
Since:
9
External Specifications

  • Nested Class Summary

    Nested classes/interfaces declared in interface Doclet

    Doclet.Option
    Modifier and Type
    Interface
    Description
    static interface 
    Doclet.Option
    An encapsulation of option name, aliases, parameters and descriptions as used by the Doclet.

  • Constructor Summary

    Constructors
    Constructor
    Description
    StandardDoclet()
    Creates an instance of the standard doclet, used to generate HTML-formatted documentation.

  • Method Summary

    Modifier and Type
    Method
    Description
    Locale
    getLocale()
    Returns the locale for this doclet.
    String
    getName()
    Returns a name identifying the doclet.
    Reporter
    getReporter()
    Returns the reporter for this doclet.
    Set<? extends Doclet.Option>
    getSupportedOptions()
    Returns all the supported options.
    SourceVersion
    getSupportedSourceVersion()
    Returns the version of the Java Programming Language supported by this doclet.
    void
    init(Locale locale, Reporter reporter)
    Initializes this doclet with the given locale and error reporter.
    boolean
    run(DocletEnvironment docEnv)
    The entry point of the doclet.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Constructor Details

    • StandardDoclet

      public StandardDoclet()
      Creates an instance of the standard doclet, used to generate HTML-formatted documentation.

  • Method Details

    • init

      public void init(Locale locale, Reporter reporter)
      Description copied from interface: Doclet
      Initializes this doclet with the given locale and error reporter. This locale will be used by the reporter and the doclet components.
      Specified by:
      init in interface Doclet
      Parameters:
      locale - the locale to be used
      reporter - the reporter to be used

    • getName

      public String getName()
      Description copied from interface: Doclet
      Returns a name identifying the doclet. A name is a simple identifier without white spaces, as defined in The Java Language Specification, section 6.2 "Names and Identifiers".
      Specified by:
      getName in interface Doclet
      Returns:
      name of the Doclet

    • getSupportedOptions

      public Set<? extends Doclet.Option> getSupportedOptions()
      Description copied from interface: Doclet
      Returns all the supported options.
      Specified by:
      getSupportedOptions in interface Doclet
      Returns:
      a set containing all the supported options, an empty set if none

    • getSupportedSourceVersion

      public SourceVersion getSupportedSourceVersion()
      Description copied from interface: Doclet
      Returns the version of the Java Programming Language supported by this doclet.
      Specified by:
      getSupportedSourceVersion in interface Doclet
      Returns:
      the language version supported by this doclet, usually the latest version

    • run

      public boolean run(DocletEnvironment docEnv)
      Description copied from interface: Doclet
      The entry point of the doclet. Further processing will commence as instructed by this method.
      Specified by:
      run in interface Doclet
      Parameters:
      docEnv - from which essential information can be extracted
      Returns:
      true on success

    • getLocale

      public Locale getLocale()
      Returns the locale for this doclet.
      Returns:
      the locale for this doclet
      Since:
      17
      See Also:

    • getReporter

      public Reporter getReporter()
      Returns the reporter for this doclet.
      Returns:
      the reporter for this doclet
      Since:
      17
      See Also: