XHTML Doclet

XHTML Doclet - Docklet for use with Javadoc, intended as a modern alternative to the Standard doclet
Download

XHTML Doclet Ranking & Summary

Advertisement

  • Rating:
  • License:
  • GPL
  • Price:
  • FREE
  • Publisher Name:
  • Quinn Taylor
  • Publisher web site:
  • Operating Systems:
  • Mac OS X
  • File Size:
  • 181 KB

XHTML Doclet Tags


XHTML Doclet Description

XHTML Doclet - Docklet for use with Javadoc, intended as a modern alternative to the Standard doclet Javadoc is an extremely useful tool for automatically generating API documentation, but the standard output has always been somewhat lacking in flexibility of format and appearance. Wouldn't it be great to make Javadoc look more like you want it to? Maybe even use those new-fangled 'web standards' the young'uns keep talking about? The truth is, the standard Javadoc HTML output is starting to show its age, both inside and out.XHTML Doclet is a doclet for use with Javadoc, intended as a modern alternative to the Standard doclet. It creates valid XHTML 1.0 Transitional markup and provides better hooks for more flexible CSS styling. The goal is to create intelligent document structure without any inline styling, resulting in greater freedom to change the appearance of all the files, either site-wide or for certain types of pages. What's New in This Release: · This release includes a lot more code refactoring and project organization. Everything in the package xhtmldoclet.* was migrated to net.sourceforge.xhtmldoclet.*, and several key classes were renamed. This means that the starting class is now "net.sourceforge.xhtmldoclet.Doclet". The GUI that appears if the doclet is executed from main() has been completely redesigned, and now works correctly whether run from class files or a JAR file. Several common internal fields and methods were refactored, including relative paths to and from the document root, getting text from the property file with string substitutions, and creating a DocletAbortException. Several bugs were resolved as well: notably, links and anchors for methods containing parameterized types are now generated correctly. XHTML Doclet now prints its version, revision, and build date when creating docs, making it easier to track which version is being used, including when testing new builds. (The first is a static field in Doclet, the latter two are read from text files generated when building the JAR file.) The Ant build script was also significantly revised, with the intent of removing platform-specific commands (such as "ls") and the shell script for StatSVN. (This is tied with using java.util.jar.* to introspect into a JAR file, avoiding the need to have an explicit listing of resources.) The compiled class directory was also changed to "build" (in the script and Eclipse) to avoid collisions and confusion. Project-specific formatting and organization settings were also added to promote source code uniformity. Please test out the code for regression and new defects!


XHTML Doclet Related Software