Doclet

From unkrig.de
Revision as of 19:16, 21 January 2016 by Aunkrig (talk | contribs)
Jump to navigation Jump to search

<meta name="keywords" content="java, doclet"></meta> <meta name="description" content="Several useful doclets for use with JAVADOC"></meta> This site makes several doclets publicly available which I wrote for my personal needs, but are hopefully useful for others. Enjoy!

The CheckStyle Doclet

Generates MEDIAWIKI-format documentation for CheckStyle and Eclipse-CS plugin-ins.

The motivation for writing this doclet was to ease the maintenance of the documentation for the Cs-contrib.unkrig.de CheckStyle plug-in. See here for an example generated page.

The generation of MEDIAWIKI documentation will be replaced with (JAVADOC-like) HTML documents.

Resources

Find the jar file here.

Find the source code for the doclet here.

Find the documentation here.

The ANT Doclet

Generates (JAVADOC-like) HTML documentation for APACHE ANT antlibs.

The motivation for writing this doclet is to ease the maintenance of the documentation for the Ant-contrib.unkrig.de antlib.

It is not (yet) completely functional.

Resources

Find the source code for the doclet here.


The JAVADOC Doclet

A drop-in replacement for the standard JAVADOC doclet that is part of the JAVADOC utility which ships with the JDK.

The main motivation was to develop a slick framework the would help me (and others) to implement other doclets (see below) more easily. After all, JAVADOC is *the* reference application of a doclet, and anybody who wants to write a doclet knows it and has an idea of how to get from the JAVADOC doclet to *his* doclet.

Getting started

To use my JAVADOC doclet, you must run the JAVADOC utility exactly as usual, but pass -doclet and -docletpath command line options to replace the built-in doclet with mine.

Doclet Options

-d dest-dir
-windowtitle text
-doctitle text
-header text
-footer text
-top text
-bottom text
-notimestamp
Same as for the original JAVADOC doclet.

Resources

Find the source code here.

Ready-to-use binaries are not (yet) available.

The MAIN Doclet

This doclet creates a (very simple) HTML page for the "main(String[])" method (or a different method) of each of the specified classes.

Doclet options

-d dest-dir
Where to create the output files. The complete output file name is "dest-dir/pkg/pkg/class.meth(int, String)".
-method method-signature
Which method to document; defaults to "main(String[])".
-output-encoding enc
The encoding to use when writing output files; defaults to the "JVM default charset".

Resources

Find the source code here.

Ready-to-use binaries are not (yet) available.