<?xml version="1.0" encoding="iso-8859-1" standalone="no"?> <!-- Generated by the JDiff Javadoc doclet --> <!-- (http://www.jdiff.org) --> <!-- on Fri Sep 04 03:04:23 EDT 2009 --> <api xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='api.xsd' name="SuperProduct 1.0" jdversion="1.0.10"> <!-- Command line arguments = -doclet jdiff.JDiff -docletpath /usr/share/java/ant.jar:/usr/share/java/ant-launcher.jar:/usr/lib/jvm/java-rpmbuild/lib/tools.jar:/home/mandrake/rpm/BUILD/jdiff/lib/jdiff.jar -classpath /usr/share/java/ant.jar:/usr/share/java/ant-launcher.jar:/usr/lib/jvm/java-rpmbuild/lib/tools.jar:/home/mandrake/rpm/BUILD/jdiff/lib/jdiff.jar -sourcepath /home/mandrake/rpm/BUILD/jdiff/examples/SuperProduct1.0 -apiname SuperProduct 1.0 -baseURI http://www.w3.org -bootclasspath /usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre/lib/resources.jar:/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre/lib/rt.jar:/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre/lib/jsse.jar:/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre/lib/jce.jar:/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre/lib/charsets.jar:/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre/lib/rhino.jar --> <package name="com.acme.sp"> <!-- start class com.acme.sp.Locator --> <class name="Locator" extends="java.lang.Object" abstract="false" static="false" final="false" visibility="public" deprecated="not deprecated"> <constructor name="Locator" static="false" final="false" visibility="public" deprecated="not deprecated"> <doc> <![CDATA[Default constructor.]]> </doc> </constructor> <doc> <![CDATA[This class can be removed when we next release.]]> </doc> </class> <!-- end class com.acme.sp.Locator --> <!-- start class com.acme.sp.Main --> <class name="Main" extends="java.lang.Object" abstract="false" static="false" final="false" visibility="public" deprecated="not deprecated"> <constructor name="Main" static="false" final="false" visibility="public" deprecated="not deprecated"> </constructor> <method name="main" abstract="false" native="false" synchronized="false" static="true" final="false" visibility="public" deprecated="not deprecated"> <param name="args" type="java.lang.String[]"/> <doc> <![CDATA[The main program for SuperProduct. Since this API does not change between versions, it does not appear in the reported differences. @param args The command line arguments]]> </doc> </method> <doc> <![CDATA[This application does nothing, but should compile cleanly and demonstrate how to use JDiff to track changes in API between versions of products.]]> </doc> </class> <!-- end class com.acme.sp.Main --> <!-- start interface com.acme.sp.SP --> <interface name="SP" abstract="true" static="false" final="false" visibility="public" deprecated="not deprecated"> <method name="saveName" return="int" abstract="false" native="false" synchronized="false" static="false" final="false" visibility="public" deprecated="not deprecated"> <param name="name" type="java.lang.String"/> <param name="value" type="int"/> <doc> <![CDATA[This method must be implemented by all classes which implement this interface.]]> </doc> </method> <doc> <![CDATA[This class is the implementation of the interface SP.]]> </doc> </interface> <!-- end interface com.acme.sp.SP --> <!-- start class com.acme.sp.SPImpl --> <class name="SPImpl" extends="java.lang.Object" abstract="false" static="false" final="false" visibility="public" deprecated="not deprecated"> <implements name="com.acme.sp.SP"/> <method name="createSP" return="com.acme.sp.SP" abstract="false" native="false" synchronized="false" static="true" final="false" visibility="public" deprecated="not deprecated"> <doc> <![CDATA[Method to create a new SP object, hidden for future flexibility.]]> </doc> </method> <method name="saveName" return="int" abstract="false" native="false" synchronized="false" static="false" final="false" visibility="public" deprecated="not deprecated"> <param name="name" type="java.lang.String"/> <param name="value" type="int"/> <doc> <![CDATA[This method was inherited from the SP interface.]]> </doc> </method> <method name="createTable" abstract="false" native="false" synchronized="false" static="true" final="false" visibility="protected" deprecated="not deprecated"> <param name="instance" type="com.acme.sp.SP"/> <doc> <![CDATA[This method will be be removed one day.]]> </doc> </method> <method name="buildLog" abstract="false" native="false" synchronized="false" static="false" final="false" visibility="protected" deprecated="not deprecated"> <param name="logName" type="java.lang.String"/> <param name="timeout" type="int"/> <doc> <![CDATA[Not sure if we've got the signature quite right in this release.]]> </doc> </method> <doc> <![CDATA[This class is the interface for accessing an SP object.]]> </doc> </class> <!-- end class com.acme.sp.SPImpl --> <doc> <![CDATA[This is the package for SuperProduct, the new product to do something or other.]]> </doc> </package> <package name="com.acme.util"> <!-- start class com.acme.util.SPUtil --> <class name="SPUtil" extends="java.lang.Object" abstract="false" static="false" final="false" visibility="public" deprecated="No replacement."> <constructor name="SPUtil" static="false" final="false" visibility="public" deprecated="not deprecated"> </constructor> <method name="bracketedString" return="java.lang.String" abstract="false" native="false" synchronized="false" static="true" final="false" visibility="public" deprecated="not deprecated"> <param name="st" type="java.lang.String"/> <doc> <![CDATA[Return the bracketed form of the given String. @param st The string to be bracketed. @return The bracketed string.]]> </doc> </method> <doc> <![CDATA[This class contains utility methods for SP and should be removed in a later release. @deprecated No replacement.]]> </doc> </class> <!-- end class com.acme.util.SPUtil --> <doc> <![CDATA[This is the rather ordinary utilities package for SuperProduct.]]> </doc> </package> </api>