You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
60 lines
1.9 KiB
60 lines
1.9 KiB
12 years ago
|
|
||
|
|
JDiff Doclet
|
||
|
|
------------
|
||
|
|
|
||
|
|
Matthew Doar
|
||
|
|
mdoar@pobox.com
|
||
|
|
|
||
|
|
|
||
|
|
The JDiff doclet is used to generate a report describing the
|
||
|
|
difference between two public Java APIs.
|
||
|
|
|
||
|
|
The file jdiff.html contains the reference page for JDiff. The latest
|
||
|
|
version of JDiff can be downloaded at:
|
||
|
|
http://sourceforge.net/projects/javadiff
|
||
|
|
|
||
|
|
To use the Ant task on your own project, see example.xml. More examples
|
||
|
|
of using JDiff to compare the public APIs of J2SE1.3 and J2SE1.4 can
|
||
|
|
be seen at http://www.jdiff.org
|
||
|
|
|
||
|
|
For an example with the source distribution, run "ant" and
|
||
|
|
look at the HTML output in ./build/reports/example/changes.html
|
||
|
|
The page at ./build/reports/example/changes/com.acme.sp.SPImpl.html
|
||
|
|
shows what a typical page of changes looks like.
|
||
|
|
|
||
|
|
System Requirements
|
||
|
|
-------------------
|
||
|
|
|
||
|
|
JDiff has been tested with all releases of Java since J2SE1.2 but
|
||
|
|
releases of JDiff after 1.10.0 focus on JDK1.5.
|
||
|
|
|
||
|
|
License
|
||
|
|
-------
|
||
|
|
|
||
|
|
JDiff is licensed under the Lesser GNU General Public License (LGPL).
|
||
|
|
See the file LICENSE.txt.
|
||
|
|
|
||
|
|
Acknowledgements
|
||
|
|
----------------
|
||
|
|
|
||
|
|
JDiff uses Stuart D. Gathman's Java translation of Gene Myers' O(ND)
|
||
|
|
difference algorithm.
|
||
|
|
|
||
|
|
JDiff uses Xerces 1.4.2 from http://www.apache.org.
|
||
|
|
|
||
|
|
JDiff also includes a script to use the classdoc application from
|
||
|
|
http://classdoc.sourceforge.net or http://www.jensgulden.de, by Jens
|
||
|
|
Gulden, (mail@jensgulden.de), to call a doclet such as jdiff on a .jar
|
||
|
|
file rather than on source.
|
||
|
|
|
||
|
|
Many thanks to the reviewers at Sun and Vitria who gave feedback on early
|
||
|
|
versions of JDiff output, and also to the distillers of Laphroaig, and to
|
||
|
|
Arturo Fuente for his consistently fine cigars which helped inspire
|
||
|
|
much of this work.
|
||
|
|
|
||
|
|
|
||
|
|
Footnote:
|
||
|
|
|
||
|
|
If you are looking for a generalized diff tool for XML, try diffmk from
|
||
|
|
http://wwws.sun.com/software/xml/developers/diffmk/
|