Reference
Community
|
The Sun Doc Check Doclet is an extension to the Javadoc tool It runs on source code and reviews documentation comments, generating an HTML report that identifies empty comments and other ommissions and irregularities in the documentation comments. The report displays the number of doc errors, categorizes problems according to severity, and suggests text to include. It can be instructed to ignore packages and classes using wildcard patterns. An included utility package contains functionality that scans a directory tree to generate a list of packages, as well as pattern-matching classes for filenames.
Support Note - DocCheck is experimental code developed originally for internal use at Sun and released to the developer community for use as-is. It is not a supported product. Use at your own risk. While we have worked to make it useful, bugs might not be fixed and features might not be added. It might not be updated, or might be re-released with a different implementation or options or page design that is incompatible with the current design.
System Requirements - Version 1.2, 1.3 and 1.4 of the Java 2 SDK, Standard Edition (J2SE).
Installation - Download the bundle to any directory you want. Uncompressing it creates a directory named doccheck1.2b2. This directory contains the DocCheck doclet and utilities (doccheck.jar), documentation, test files, and the doclet source code.
What's New in 1.2 Beta 2 - The only change in version 1.2 Beta 2 is that it now also runs on version 1.4 of the Java 2 SDK.
Feedback and Reporting Bugs - Please send us your feedback on the contents of this release. In particular, let us know if you feel the technology contained in this release is useful, and if it is not, let us know what you found lacking. The goal of this release is to gather input from developers that will allow us to improve the design of the DocCheck. Please send comments and detailed bug reports to: doccheck-feedback@java.sun.com
 |
 |