HADOOP-2457. Added a 'forrest.home' property to the 'docs' target in build.xml.

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

CHANGES.txt

@@ -129,6 +129,9 @@ Trunk (unreleased changes)
     HADOOP-2432. HDFS includes the name of the file while throwing 
     "File does not exist"  exception. (Jim Kellerman via dhruba)
 
+    HADOOP-2457. Added a 'forrest.home' property to the 'docs' target in
+    build.xml. (acmurthy) 
+
   OPTIMIZATIONS
 
     HADOOP-1898.  Release the lock protecting the last time of the last stack

build.xml

@@ -608,8 +608,8 @@
   <!-- Documentation                                                      -->
   <!-- ================================================================== -->
   
-  <target name="docs" description="Generate documentation">
-    <exec dir="${docs.src}" executable="forrest" failonerror="true" />
+  <target name="docs" depends="forrest.check" description="Generate forrest-based documentation. To use, specify -Dforrest.home=&lt;base of Apache Forrest installation&gt; on the command line." if="forrest.home">
+    <exec dir="${docs.src}" executable="${forrest.home}/bin/forrest" failonerror="true" />
     <copy todir="${docs.dir}">
       <fileset dir="${docs.src}/build/site/" />
     </copy>
@@ -617,6 +617,10 @@
            includes="hadoop-default.xml" style="conf/configuration.xsl"/>
   </target>
 
+  <target name="forrest.check" unless="forrest.home">
+    <fail message="'forrest.home' is not defined. Please pass -Dforrest.home=&lt;base of Apache Forrest installation&gt; to Ant on the command-line." />
+  </target>
+	
   <target name="javadoc" description="Generate javadoc">
     <mkdir dir="${build.javadoc}"/>
     <javadoc