| 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/ |