DocFlex/Javadoc is both a template-driven multi-format Javadoc doclet and a visual graphic Template Designer for it.
DocFlex/Javadoc is able to generate Java API documentation or anything else produced from the data provided by Doclet API. The output can be generated in HTML (both multi-framed and single file), exceptional quality MS Word friendly RTF and plain text output formats.
The RTF output generator supports rendering of most HTML 3.2 tags (and their attributes) embedded in Java comments. This includes images, tables of any complexity and lists. In effect, besides the Java API documentation, the generator acts as a mini browser of HTML into RTF. More output formats are coming in the future versions!
The graphics Template Designer represents the whole Doclet API in the form of a virtual "XML document" with a very compact structure. This makes possible to process information provided by Doclet API using queries similar to XPath.
What's more, the template approach allows almost to avoid writing any code! Instead of programming your doclet on the level of abstract Java operators, you can visually design most of the stuff you want to produce in terms of things appearing in the output documentation simply by using mouse and specifying properties in the Template Designer dialogs.
Using the basic template set provided with DocFlex/Javadoc, you can quickly customize your Javadoc without writing a full-blown doclet from scratch!
DocFlex/Javadoc comes in two editions: the full one and the freeware edition called DocFlex/Doclet.
DocFlex/Doclet includes only the output generator and a set of build-in templates without Template Designer. You may simply use it for free as the best quality RTF generator for Javadoc Tool. Besides this, you can use DocFlex/Doclet as a free interpreter for your custom templates with possibility to redistribute it together with your templates as you need!
(*) Performance improvement
Thanks to implementing of a new algorithm of handling cascading formatting properties of template components, the general performance of all output generators has been improved up to 30%!
Here is the result of a single file RTF documentation generation for Java sources contained in
javax.swing package and its subpackages supplied with JDK 1.4:
Number of Java classes: 540 Total source code size: 8.2 Mb Generation time: 199 sec Result RTF document: 20.5 Mb Number of pages (A4): 3012 Computer platform: AMD Athlon64 3000+ based system / Windows XP
(*) A new template parameter "Exclude By Tags" has been introduced in basic templates. This parameter allows to exclude from the generated documentation classes, fields and methods with specified tags.
Parameters in DocFlex templates serves the same role as ordinary command line options in ordinary doclet. Since all output generation is programmed within templates, the template parameters can control it in any way you wish.
(*) More command line option support
(*) A new HTML output option "Add Mark of the Web" has been introduced.
Setting this option will avoid the security alert messages popping up by Microsoft Internet Explorer under Windows XP SP2 when viewing the HTML documentation generated by DocFlex.
DocFlex/Javadoc home page: