annotate test/tools/doclint/tidy/README.txt @ 1714:6b07f409943e

merge with jdk8-b71
author mcimadamore
date Wed, 09 Jan 2013 17:55:02 +0100
rev   line source
mcimadamore@1714 1 The utilities in this directory can be used to determine
mcimadamore@1714 2 common issues in javadoc comments by running the standard
mcimadamore@1714 3 "tidy" program on the output of javadoc, and analysing
mcimadamore@1714 4 the messages that are reported.
mcimadamore@1714 5
mcimadamore@1714 6 is a script that will run the "tidy" program on
mcimadamore@1714 7 the files in a directory, writing the results to a new
mcimadamore@1714 8 directroy.
mcimadamore@1714 9
mcimadamore@1714 10 tidystats.Main is a Java program that can analyze the
mcimadamore@1714 11 files produced by the script to generate a
mcimadamore@1714 12 summary report about the warnings that were found.
mcimadamore@1714 13
mcimadamore@1714 14
mcimadamore@1714 15 The tests is this directory are focussed on verifying
mcimadamore@1714 16 that doclint detects issues in javadoc comments that will
mcimadamore@1714 17 give rise to issues detected by "tidy" in the output
mcimadamore@1714 18 generated by javadoc.
mcimadamore@1714 19
mcimadamore@1714 20 For more information on the "tidy" program, see the HTML Tidy
mcimadamore@1714 21 Library Project page at