Doclet: Difference between revisions

From unkrig.de
Jump to navigation Jump to search
(Created page with "This site makes several doclets publicly available which I wrote for my personal needs, but are hopefully useful for others. Enjoy! == The JAVADOC Doclet == A drop-in replac...")
 
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
<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!
This site makes several doclets publicly available which I wrote for my personal needs, but are hopefully useful for others. Enjoy!
== The ANT Doclet ==
Generates (JAVADOC-like) HTML documentation for [http://ant.apache.org APACHE ANT] antlibs.
The motivation for writing this doclet is to ease the maintenance of the documentation for the [[Antology]] antlib.
[[ANT doclet|Read more...]]
== The CheckStyle Doclet ==
Generates (JAVADOC-like) HTML documentation and the metadata files for [http://checkstyle.sf.net CheckStyle] and [http://eclipse-cs.sf.net Eclipse-CS] plugin-ins from "doc tags" in the source code of your checks and filters.
[[Cs-doclet|Read more...]]


== The JAVADOC Doclet ==
== The JAVADOC Doclet ==


A drop-in replacement for the standard JAVADOC doclet that is part of the JAVADOC utility which ships with the JDK.
A re-implementation of the JAVADOC standard doclet, basically a reference to show how to use [https://github.com/aunkrig/no-template the "no-template" framework].
 
[[JAVADOC doclet|Read more...]]


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.
== The MAIN Doclet ==


=== Getting started ===
Generates an HTML page for the <code>main(String[])</code> method (or any other method) of each of the specified classes. This is useful for command line tools with a set of command line options. Converted to plain text (e.g. with the [[html2txt]] utility), that documentation is perfect for a self description that a command line utility would print in response to <code>--help</code>.


To use my JAVADOC doclet, you must run the JAVADOC utility exactly as usual, but pass <code>-doclet</code> and <tt>-docletpath</tt> command line options to replace the built-in doclet with mine.
[[MAIN doclet|Read more...]]

Latest revision as of 16:47, 12 February 2017

<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 ANT Doclet[edit]

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 Antology antlib.

Read more...

The CheckStyle Doclet[edit]

Generates (JAVADOC-like) HTML documentation and the metadata files for CheckStyle and Eclipse-CS plugin-ins from "doc tags" in the source code of your checks and filters.

Read more...

The JAVADOC Doclet[edit]

A re-implementation of the JAVADOC standard doclet, basically a reference to show how to use the "no-template" framework.

Read more...

The MAIN Doclet[edit]

Generates an HTML page for the main(String[]) method (or any other method) of each of the specified classes. This is useful for command line tools with a set of command line options. Converted to plain text (e.g. with the html2txt utility), that documentation is perfect for a self description that a command line utility would print in response to --help.

Read more...