|
FlexDoc/Javadoc 2.0 Demo Java Doc |
Interface Doclet
All Known Implementing Classes:
public interface Doclet
The user doclet must implement this interface, as described in the
package description.
Each implementation of a Doclet must provide a public no-argument constructor
to be used by tools to instantiate the doclet. The tool infrastructure will
interact with classes implementing this interface as follows:
- The tool will create an instance of a doclet using the no-arg constructor
of the doclet class.
- Next, the tool calls the init method with an appropriate locale
and reporter.
- Afterwards, the tool calls getSupportedOptions,
and getSupportedSourceVersion.
These methods are only called once.
- As appropriate, the tool calls the run method on the doclet
object, giving it a DocletEnvironment object, from which the doclet can determine
the elements to be included in the documentation.
If a doclet object is created and used without the above protocol being followed,
then the doclet's behavior is not defined by this interface specification.
To start the doclet, pass -doclet followed by the fully-qualified
name of the entry point class (i.e. the implementation of this interface) on
the javadoc tool command line.
Since:
9
Nested Class Summary |
static interface |
An encapsulation of option name, aliases, parameters and descriptions
as used by the Doclet.
|
Method Summary |
|
Returns a name identifying the doclet.
|
|
Returns all the supported options.
|
|
Returns the version of the Java Programming Language supported
by this doclet.
|
void |
Initializes this doclet with the given locale and error reporter.
|
boolean |
The entry point of the doclet.
|
Initializes this doclet with the given locale and error reporter.
This locale will be used by the reporter and the doclet components.
Parameters:
locale - the locale to be used
reporter - the reporter to be used
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".
Returns:
name of the Doclet
Returns all the supported options.
Returns:
a set containing all the supported options, an empty set if none
getSupportedSourceVersion
Returns the version of the Java Programming Language supported
by this doclet.
Returns:
the language version supported by this doclet, usually
the latest version
The entry point of the doclet. Further processing will commence as
instructed by this method.
Parameters:
environment - from which essential information can be extracted
Returns:
true on success
|
FlexDoc/Javadoc 2.0 Demo Java Doc |
FlexDoc/Javadoc is a template-driven programming tool for rapid development of any Javadoc-based Java API documentation generators (i.e. doclets). If you need to customize your Javadoc without writing a full-blown doclet from scratch,
FlexDoc/Javadoc may be the only tool able to help you! Find out more at
www.flexdoc.xyz