Javadoc is a tool that parses the declarations and documentation comments
in a set of source files and produces a set of HTML pages describing
the classes, inner classes, interfaces, constructors, methods, and fields.
You can use Javadoc doclets to customize Javadoc output. A
doclet is a program written with the doclet API that
specifies the content and
format of the output to be generated by the javadoc tool.
You can write a doclet to generate any kind of text-file output, such as
HTML, SGML, XML, RTF, and MIF. SunTM
provides a "standard"
doclet for generating HTML-format API documentation.
Doclets can also be used to perform special tasks not related to
producing API documentation. For example, a diagnostic doclet could be
created to check that all class members of the classes on which
Javadoc operates have documentation comments.
The standard doclet is the doclet provided by Sun that produces the
default HTML-formatted API output. Javadoc uses the standard doclet
if no other doclet is specified with Javadoc's -doclet
option. This document is an introduction to the standard doclet.
We'd like to know about doclets that you create. If you would
like us to consider adding a link from the
doclets page
to your doclet's output, send the URL to
javadoc-tool@sun.com.