From 9542bdb77744ebcd7fe94f17249130ac5c444869 Mon Sep 17 00:00:00 2001
From: cantor <cantor@ab3bd59b-922f-494d-bb5f-6f0a3c29deca>
Date: Mon, 17 Jun 2002 19:10:53 +0000
Subject: [PATCH] Added javadoc target

git-svn-id: https://subversion.switch.ch/svn/shibboleth/java-idp/trunk@137 ab3bd59b-922f-494d-bb5f-6f0a3c29deca
---
 build.xml |  226 +++++++++++++++++++++++++++++++++----------------------------
 1 file changed, 123 insertions(+), 103 deletions(-)

diff --git a/build.xml b/build.xml
index 1b930ec..6865c1f 100755
--- a/build.xml
+++ b/build.xml
@@ -2,113 +2,133 @@
 
 <project name="Shibboleth" default="dist-all" basedir=".">
 
-	<!-- Set global properties for this build -->
-	<property name="distname" value="shibboleth" />
-	<property name="root" value="." />
-	<property name="src" value="${root}/src" />
-	<property name="approot" value="${root}/webApplication" />
-	<property name="configroot" value="${root}/webAppConfig" />
-	<property name="build" value="${approot}/WEB-INF/classes" />
-	<property name="libdir" value="${approot}/WEB-INF/lib" />
-	<property name="buildlibs" value="${root}/lib" />
-	<property name="dist" value="${root}/dist" />
-
-
-	<!-- Construct the CLASSPATH -->
-	<path id="build.path">
-		<pathelement path="${classpath}" />
-		<pathelement location="${build}" />
-		<fileset dir="${libdir}">
-			<include name="**/*.jar" />
-		</fileset>
-		<fileset dir="${buildlibs}">
-			<include name="**/*.jar" />
-		</fileset>
-	</path>
-
-
-	<!-- Prepare directory structure for project build-->
-	<target name="init">
-	<mkdir dir="${build}" />
-	<mkdir dir="${dist}" />
+    <!-- Set global properties for this build -->
+    <property name="distname" value="shibboleth" />
+    <property name="root" value="." />
+    <property name="src" value="${root}/src" />
+    <property name="approot" value="${root}/webApplication" />
+    <property name="configroot" value="${root}/webAppConfig" />
+    <property name="build" value="${approot}/WEB-INF/classes" />
+    <property name="libdir" value="${approot}/WEB-INF/lib" />
+    <property name="buildlibs" value="${root}/lib" />
+    <property name="dist" value="${root}/dist" />
+    <property name="docs" value="${root}/docs" />
+    <property name="javadocs" value="${docs}/api" />
+
+    <property name="year" value="2002"/>
+    <property name="copyright" value="Copyright &#169; ${year} UCAID. All Rights Reserved."/>
+
+
+    <!-- Construct the CLASSPATH -->
+    <path id="build.path">
+        <pathelement path="${classpath}" />
+        <pathelement location="${build}" />
+        <fileset dir="${libdir}">
+            <include name="**/*.jar" />
+        </fileset>
+        <fileset dir="${buildlibs}">
+            <include name="**/*.jar" />
+        </fileset>
+    </path>
+
+
+    <!-- Prepare directory structure for project build-->
+    <target name="init">
+    <mkdir dir="${build}" />
+    <mkdir dir="${dist}" />
+    </target>
+
+
+    <!-- This target should be run before checking code into the repository -->
+    <target name="pre-checkin" depends="compile-all, test-all, clean-all" />
+
+
+    <!-- Compile classes and move them to ${build} -->
+    <target name="compile-all" depends="init">
+        <javac srcdir="${src}" destdir="${build}" includes="**/*.java" debug="on">
+            <exclude name="edu/internet2/middleware/shibboleth/hs-cmu/**" />
+            <classpath refid="build.path" />
+        </javac>
+        <copy todir="${build}/schemas">
+            <fileset dir="${src}/schemas"/>
+        </copy>
+    </target>
+
+
+	<!-- Generate API docs -->
+	<target name="javadocs">
+		<mkdir dir="${docs}" />
+		<mkdir dir="${javadocs}" />
+		<javadoc packagenames='edu.internet2.middleware.*'
+			sourcepath='${src}' destdir='${javadocs}'
+			author='true' version='true'
+			windowtitle='Shibboleth Java API' doctitle='Shibboleth Java API'
+			bottom='${copyright}'>
+                <classpath refid="build.path" />
+        </javadoc>
 	</target>
 
-
-	<!-- This target should be run before checking code into the repository -->
-	<target name="pre-checkin" depends="compile-all, test-all, clean-all" />
-
-
-	<!-- Compile classes and move them to ${build} -->
-	<target name="compile-all" depends="init">
-		<javac srcdir="${src}" destdir="${build}" includes="**/*.java" debug="on">
-			<exclude name="edu/internet2/middleware/shibboleth/hs-cmu/**" />
-			<classpath refid="build.path" />
-		</javac>
-		<copy todir="${build}/schemas">
-                        <fileset dir="${src}/schemas"/>
-                </copy>
-	</target>
-
-
-
-	<!-- Create various product distributions and move them to ${dist} -->
-	<target name="dist" depends="dist-all" />
-	<target name="dist-all" depends="compile-all, test-all, package-all, clean-build" />
-	<target name="package-all">
-		<war warfile="${dist}/${distname}.war" webxml="${approot}/WEB-INF/web.xml" basedir="${approot}" update="no" />
-	</target>
-
-	<target name="dist-origin" depends="compile-all, test-origin, package-origin, clean-build" />
-	<target name="package-origin">
-		<war warfile="${dist}/${distname}-origin.war" webxml="${configroot}/origin.xml" basedir="${approot}" update="no" />
-	</target>
-
-	<target name="dist-target" depends="compile-all, test-target, package-target, clean-build" />
-	<target name="package-target">
-		<war warfile="${dist}/${distname}-target.war" webxml="${configroot}/target.xml" basedir="${approot}" update="no" />
+    <!-- Create various product distributions and move them to ${dist} -->
+    <target name="dist" depends="dist-all" />
+    <target name="dist-all" depends="compile-all, test-all, package-all, clean-build" />
+    <target name="package-all">
+        <war warfile="${dist}/${distname}.war" webxml="${approot}/WEB-INF/web.xml" basedir="${approot}" update="no" />
+    </target>
+
+    <target name="dist-origin" depends="compile-all, test-origin, package-origin, clean-build" />
+    <target name="package-origin">
+        <war warfile="${dist}/${distname}-origin.war" webxml="${configroot}/origin.xml" basedir="${approot}" update="no" />
+    </target>
+
+    <target name="dist-target" depends="compile-all, test-target, package-target, clean-build" />
+    <target name="package-target">
+        <war warfile="${dist}/${distname}-target.war" webxml="${configroot}/target.xml" basedir="${approot}" update="no" />
+    </target>
+
+    <target name="dist-target-includeswayf" depends="compile-all, test-target, test-wayf, package-target-includeswayf, clean-build" />
+    <target name="package-target-includeswayf">
+        <war warfile="${dist}/${distname}-target.war" webxml="${configroot}/target-includeswayf.xml" basedir="${approot}" update="no" />
+    </target>
+
+    <target name="dist-wayf" depends="compile-all, test-wayf, package-wayf, clean-build" />
+    <target name="package-wayf">
+        <war warfile="${dist}/${distname}-wayf.war" webxml="${configroot}/wayf.xml" basedir="${approot}" update="no" />
+    </target>
+
+
+    <!-- Cleanup after the build, test, and distribution processes -->
+    <target name="clean" depends="clean-all" />
+    <target name="clean-all" depends="clean-build, clean-dist, clean-test, clean-javadocs" />
+    <target name="clean-build">
+        <delete dir="${build}" />
+    </target>
+    <target name="clean-test">
+        <delete>
+            <fileset dir="${root}">
+                <include name="**/TEST*.txt" />
+            </fileset>
+        </delete>
+    </target>
+    <target name="clean-dist">
+        <delete dir="${dist}" />
+    </target>
+	<target name="clean-javadocs">
+		<delete dir="${javadocs}" />
 	</target>
 
-	<target name="dist-target-includeswayf" depends="compile-all, test-target, test-wayf, package-target-includeswayf, clean-build" />
-	<target name="package-target-includeswayf">
-		<war warfile="${dist}/${distname}-target.war" webxml="${configroot}/target-includeswayf.xml" basedir="${approot}" update="no" />
-	</target>
-
-	<target name="dist-wayf" depends="compile-all, test-wayf, package-wayf, clean-build" />
-	<target name="package-wayf">
-		<war warfile="${dist}/${distname}-wayf.war" webxml="${configroot}/wayf.xml" basedir="${approot}" update="no" />
-	</target>
-
-
-	<!-- Cleanup after the build, test, and distribution processes -->
-	<target name="clean" depends="clean-all" />
-	<target name="clean-all" depends="clean-build, clean-dist, clean-test" />
-	<target name="clean-build">
-		<delete dir="${build}" />
-	</target>
-	<target name="clean-test">
-		<delete>
-			<fileset dir="${root}">
-				<include name="**/TEST*.txt" />
-			</fileset>
-		</delete>
-	</target>
-	<target name="clean-dist">
-		<delete dir="${dist}" />
-	</target>
-
-	
-	<!-- Run automated tests on compiled code -->
-	<target name="test-all" depends="test-origin, test-target, test-wayf" />
-	<target name="test-origin" depends="test-common" />
-	<target name="test-target" depends="test-common" />
-	<target name="test-wayf" depends="test-common" />
-	<target name="test-common" depends="compile-all">
-		<junit printsummary="no" fork="no" haltonfailure="yes" haltonerror="no">
-			<classpath refid="build.path" />
-			<formatter type="plain" />
-		<!--	<test name="edu.internet2.middleware.shibboleth.common.AQHTest" /> -->
-		</junit>
-	</target>
+    
+    <!-- Run automated tests on compiled code -->
+    <target name="test-all" depends="test-origin, test-target, test-wayf" />
+    <target name="test-origin" depends="test-common" />
+    <target name="test-target" depends="test-common" />
+    <target name="test-wayf" depends="test-common" />
+    <target name="test-common" depends="compile-all">
+        <junit printsummary="no" fork="no" haltonfailure="yes" haltonerror="no">
+            <classpath refid="build.path" />
+            <formatter type="plain" />
+        <!-- <test name="edu.internet2.middleware.shibboleth.common.AQHTest" /> -->
+        </junit>
+    </target>
 
 </project>
 
-- 
1.7.10.4