HADOOP-3532. Add jdiff reports to the build scripts. Contributed by Owen

O'Malley.


git-svn-id: https://svn.apache.org/repos/asf/hadoop/core/trunk@672791 13f79535-47bb-0310-9956-ffa450edef68

CHANGES.txt

@@ -333,6 +333,8 @@ Release 0.18.0 - Unreleased
 
     HADOOP-3606. Updates the Streaming doc. (Amareshwari Sriramadasu via ddas) 
 
+    HADOOP-3532. Add jdiff reports to the build scripts. (omalley)
+
   OPTIMIZATIONS
 
     HADOOP-3274. The default constructor of BytesWritable creates empty 

build.xml

@@ -120,6 +120,11 @@
   <property name="clover.report.dir" location="${build.dir}/test/clover/reports"/>
 
   <property name="rat.reporting.classname" value="rat.Report"/>
+  <property name="jdiff.home" value="${user.home}/jdiff-1.1.0"/>
+  <property name="jdiff.reports.dir" value="${docs.dir}/jdiff"/>
+  <property name="jdiff.stable" value="0.17.0"/>
+  <property name="jdiff.stable.javadoc" 
+            value="http://hadoop.apache.org/core/docs/r${jdiff.stable}/api/"/>
 
   <property name="scratch.dir" value="${user.home}/tmp"/>
   <property name="svn.cmd" value="svn"/>
@@ -793,6 +798,45 @@
 
     </javadoc>
   </target>	
+
+  <target name="api-xml" depends="javadoc">
+    <javadoc>
+       <doclet name="jdiff.JDiff"
+               path="${jdiff.home}/jdiff.jar:${jdiff.home}/xerces.jar">
+         <param name="-apidir" value="${build.dir}"/>
+         <param name="-apiname" value="hadoop ${version}"/>
+       </doclet>
+       <packageset dir="src/core"/>
+       <packageset dir="src/hdfs"/>
+       <packageset dir="src/mapred"/>
+       <packageset dir="src/tools"/>
+       <classpath >
+         <path refid="classpath" />
+         <pathelement path="${java.class.path}"/>
+       </classpath>
+    </javadoc>
+  </target>
+	
+  <target name="api-report" depends="api-xml">
+    <javadoc sourcepath="src/core,src/hdfs,src,mapred,src/tools"
+             destdir="${build.dir}"
+             sourceFiles="${jdiff.home}/Null.java">
+       <doclet name="jdiff.JDiff"
+               path="${jdiff.home}/jdiff.jar:${jdiff.home}/xerces.jar">
+         <param name="-oldapi" value="hadoop ${jdiff.stable}"/>
+         <param name="-newapi" value="hadoop ${version}"/>
+         <param name="-oldapidir" value="${jdiff.reports.dir}"/>
+         <param name="-newapidir" value="${build.dir}"/>
+         <param name="-javadocold" value="${jdiff.stable.javadoc}"/>
+         <param name="-javadocnew" value="${build.javadoc}/"/>
+         <param name="-stats"/>
+       </doclet>
+       <classpath >
+         <path refid="classpath" />
+         <pathelement path="${java.class.path}"/>
+       </classpath>
+    </javadoc>
+  </target>
 	
   <target name="changes-to-html" description="Convert CHANGES.txt into an html file">
     <mkdir dir="${docs.dir}"/>