langtools/test/tools/doclint/tidy/README.txt
author katleman
Tue, 21 Jan 2014 18:17:23 -0800
changeset 22365 895bfde469d4
parent 14952 d0022ae20516
permissions -rw-r--r--
Added tag jdk9-b01 for changeset ae2d94255f32
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     1
The utilities in this directory can be used to determine
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     2
common issues in javadoc comments by running the standard
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     3
"tidy" program on the output of javadoc, and analysing
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     4
the messages that are reported.
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     5
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     6
tidy.sh is a script that will run the "tidy" program on
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     7
the files in a directory, writing the results to a new
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     8
directroy.
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     9
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    10
tidystats.Main is a Java program that can analyze the 
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    11
files produced by the tidy.sh script to generate a 
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    12
summary report about the warnings that were found.
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    13
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    14
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    15
The tests is this directory are focussed on verifying
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    16
that doclint detects issues in javadoc comments that will
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    17
give rise to issues detected by "tidy" in the output
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    18
generated by javadoc. 
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    19
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    20
For more information on the "tidy" program, see the HTML Tidy
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    21
Library Project page at http://tidy.sourceforge.net/.