net.cscott.sinjdoc

Class Doclet

public abstract class Doclet extends Object

The Doclet class provides the entry-point methods for a documentation generator.

Version: $Id: Doclet.java,v 1.3 2003/05/08 03:54:25 cananian Exp $

Author: C. Scott Ananian (cscott@cscott.net)

See Also: com.sun.javadoc.Doclet

Method Summary
StringgetName()
Return a short human-friendly string naming this Doclet.
voidoptionHelp(DocErrorReporter reporter)
Print help text describing the options accepted by this doclet.
intoptionLength(String option)
Check for doclet-added options here.
abstract booleanstart(RootDoc root)
Generate documentation here.
booleanvalidOptions(List<List<String>> options, DocErrorReporter reporter)
Check that options have the correct arguments here.

Method Detail

getName

public String getName()
Return a short human-friendly string naming this Doclet.

optionHelp

public void optionHelp(DocErrorReporter reporter)
Print help text describing the options accepted by this doclet.

This method is not required and will default gracefully (not printing anything) if absent.

Printing should be done using reporter.printNotice(msg).

optionLength

public int optionLength(String option)
Check for doclet-added options here.

This method is not required and will default gracefully (to zero) if absent.

Returns: Number of arguments to option. Zero returns means option not known. Negative value means error occurred.

start

public abstract boolean start(RootDoc root)
Generate documentation here.

Returns: true on success.

validOptions

public boolean validOptions(List<List<String>> options, DocErrorReporter reporter)
Check that options have the correct arguments here.

This method is not required and will default gracefully (to true) if absent.

Printing option-related error messages (using the provided DocErrorReporter is the responsibility of this method.

Returns: true if the options are valid.

Copyright © 2003 C. Scott Ananian