svn commit: r699119 [1/3] - in /hadoop/core/trunk: CHANGES.txt build.xml docs/jdiff/hadoop_0.18.1.xml src/docs/src/documentation/conf/cli.xconf src/docs/src/documentation/content/xdocs/site.xml

[cutting]

Author: cutting
Date: Thu Sep 25 15:40:34 2008
New Revision: 699119

URL: http://svn.apache.org/viewvc?rev=699119&view=rev
Log:
HADOOP-2421.  Add jdiff output to documentation, listing all API changes from 
the prior release.

Added:
    hadoop/core/trunk/docs/jdiff/hadoop_0.18.1.xml
Modified:
    hadoop/core/trunk/CHANGES.txt
    hadoop/core/trunk/build.xml
    hadoop/core/trunk/src/docs/src/documentation/conf/cli.xconf
    hadoop/core/trunk/src/docs/src/documentation/content/xdocs/site.xml

Modified: hadoop/core/trunk/CHANGES.txt
URL: 
http://svn.apache.org/viewvc/hadoop/core/trunk/CHANGES.txt?rev=699119&r1=699118&r2=699119&view=diff
==============================================================================
--- hadoop/core/trunk/CHANGES.txt (original)
+++ hadoop/core/trunk/CHANGES.txt Thu Sep 25 15:40:34 2008
@@ -229,6 +229,9 @@
     HADOOP-3924. Added a 'KILLED' job status. (Subramaniam Krishnan via
     acmurthy) 
 
+    HADOOP-2421.  Add jdiff output to documentation, listing all API
+    changes from the prior release.  (cutting)
+
   IMPROVEMENTS
 
     HADOOP-4205. hive: metastore and ql to use the refactored SerDe library.

Modified: hadoop/core/trunk/build.xml
URL: 
http://svn.apache.org/viewvc/hadoop/core/trunk/build.xml?rev=699119&r1=699118&r2=699119&view=diff
==============================================================================
--- hadoop/core/trunk/build.xml (original)
+++ hadoop/core/trunk/build.xml Thu Sep 25 15:40:34 2008
@@ -126,9 +126,10 @@
   <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.build.dir" value="${build.docs}/jdiff"/>
+  <property name="jdiff.xml.dir" value="${docs.dir}/jdiff"/>
+  <property name="jdiff.stable" value="0.18.1"/>
   <property name="jdiff.stable.javadoc" 
             value="http://hadoop.apache.org/core/docs/r${jdiff.stable}/api/"/>
 
@@ -868,15 +869,18 @@
     </javadoc>
   </target>    
 
-  <target name="api-xml" depends="javadoc">
+  <target name="jdiff.check" unless="jdiff.home">
+    <fail message="'jdiff.home' is not defined. Please pass 
-Djdiff.home=&lt;base of jdiff installation&gt; to Ant on the command-line." />
+  </target>
+
+  <target name="api-xml" depends="jdiff.check,javadoc">
     <javadoc>
        <doclet name="jdiff.JDiff"
                path="${jdiff.home}/jdiff.jar:${jdiff.home}/xerces.jar">
-         <param name="-apidir" value="${build.dir}"/>
+         <param name="-apidir" value="${jdiff.xml.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 >
@@ -887,15 +891,16 @@
   </target>
        
   <target name="api-report" depends="api-xml">
+    <mkdir dir="${jdiff.build.dir}"/>
     <javadoc sourcepath="src/core,src/hdfs,src,mapred,src/tools"
-             destdir="${build.dir}"
+             destdir="${jdiff.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="-oldapidir" value="${jdiff.xml.dir}"/>
+         <param name="-newapidir" value="${jdiff.xml.dir}"/>
          <param name="-javadocold" value="${jdiff.stable.javadoc}"/>
          <param name="-javadocnew" value="${build.javadoc}/"/>
          <param name="-stats"/>
@@ -930,6 +935,7 @@
     <mkdir dir="${dist.dir}/bin"/>
     <mkdir dir="${dist.dir}/docs"/>
     <mkdir dir="${dist.dir}/docs/api"/>
+    <mkdir dir="${dist.dir}/docs/jdiff"/>
 
     <copy todir="${dist.dir}/lib" includeEmptyDirs="false">
       <fileset dir="lib">