<?xml version="1.0"?>
<!-- Generated by the JDiff Javadoc doclet -->
<!-- (http://www.pobox.com/~doar/src/jdiff) -->
<!-- on Wed Oct 17 01:10:51 PDT 2001 -->

<!-- XML Schema is used, but XHTML transitional DTD is needed for nbsp -->
<!-- entity definitions etc.-->
<!DOCTYPE api
     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<api
  xmlns:xsi='http://www.w3.org/2000/10/XMLSchema-instance'
  xsi:noNamespaceSchemaLocation='api.xsd'
  name="SuperProduct 1.0"
  jdversion="1.0.1">

<!--  Command line arguments =  -doclet jdiff.JDiff -docletpath ..\..\lib\jdiff.jar -apiname SuperProduct 1.0 -sourcepath ..\SuperProduct1.0 -->
<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.]]>
      </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"    abstract="false"
    static="false" final="false" visibility="public"
    deprecated="not deprecated">
    <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.]]>
      </doc>
    </method>
    <doc>
    <![CDATA[This class contains utility methods for SP and
 should be removed in a later release.]]>
    </doc>
  </class>
  <!-- end class com.acme.util.SPUtil -->
  <doc>
  <![CDATA[This is the rather ordinary utilities package for SuperProduct.]]>
  </doc>
</package>

</api>