build file for docs. Currently separate but can be integrated with

main build file later on git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@269496 13f79535-47bb-0310-9956-ffa450edef68
24 years ago · 15dd8a7949
--- a/build.xml
+++ b/build.xml
@@ -333,10 +333,17 @@
      <param name="dist.dir" value="${dist.name}" />
    </antcall>
  </target>  

  <target name="dist_javadocs" depends="javadocs">
    <mkdir dir="${dist.javadocs}"/>
    <copy todir="${dist.javadocs}" overwrite="true">
      <fileset dir="${build.javadocs}"/>
    </copy>
  </target>
  
  <target name="internal_dist" depends="dist-lite,javadocs">
  
  <target name="internal_dist" depends="dist-lite,dist_javadocs">
    <mkdir dir="${dist.docs}"/>
    <mkdir dir="${dist.javadocs}"/>

    <copy todir="${dist.lib}">
      <fileset dir="${lib.dir}">
@@ -352,10 +359,6 @@
      <fileset dir="${docs.dir}"/>
    </copy>

    <copy todir="${dist.javadocs}" overwrite="true">
      <fileset dir="${build.javadocs}"/>
    </copy>

    <copy todir="${dist.dir}">
      <fileset dir=".">
        <include name="README"/>
--- a/docs.xml
+++ b/docs.xml
@@ -0,0 +1,64 @@
 <project name="build-site" default="docs" basedir=".">

    <!-- Initialization properties -->
    <property name="project.name" value="ant"/>
    <property name="docs.src"     location="xdocs"/>
    <property name="docs.dest"    location="docs"/>
    <property name="project.file" value="stylesheets/project.xml" />
    <property name="site.dir"     location="../jakarta-site2" />
    <property name="templ.path"   location="xdocs/stylesheets" />
    <property name="velocity.props"   location="${docs.src}/velocity.properties" />

    <path id="anakia.classpath">
        <fileset dir="${site.dir}/lib">
            <include name="*.jar"/>
        </fileset>
    </path>

    <target name="prepare">    
        <available classname="org.apache.velocity.anakia.AnakiaTask" 
                   property="AnakiaTask.present">
            <classpath refid="anakia.classpath"/>
        </available>
    </target>

    <target depends="prepare" name="prepare-error" unless="AnakiaTask.present">
        <echo>
            AnakiaTask is not present! Please check to make sure that 
            velocity.jar is in your classpath.
        </echo>
    </target>

    <target name="docs" depends="prepare-error" if="AnakiaTask.present">
        <taskdef name="anakia" classname="org.apache.velocity.anakia.AnakiaTask" reverseloader="true">
            <classpath refid="anakia.classpath"/>
        </taskdef>
        
        <anakia basedir="${docs.src}" destdir="${docs.dest}/"
             extension=".html" style="./site.vsl"
             projectFile="${project.file}"
             excludes="**/stylesheets/** faq.xml"
             includes="**/*.xml"
             lastModifiedCheck="true"
             templatePath="${templ.path}"
             velocityPropertiesFile="${velocity.props}">
        </anakia>

        <anakia basedir="${docs.src}" destdir="${docs.dest}/"
             extension=".html" style="./faq.vsl"
             projectFile="${project.file}"
             includes="faq.xml"
             lastModifiedCheck="true"
             templatePath="${templ.path}"
             velocityPropertiesFile="${velocity.props}">
        </anakia>
    </target>
    
    <target name="javadocs">
      <ant antfile="build.xml" target="dist_javadocs">
        <property name="dist.javadocs" value="${docs.dest}/manual/api" />
      </ant>
    </target>
    
    <target name="all" depends="docs, javadocs"/>
 </project>
--- a/docs/manual/api/index.html
+++ b/docs/manual/api/index.html
@@ -1,11 +1,25 @@
 <html>
 <head>
 <meta http-equiv="refresh" content="1; URL=packages.html">
 <title>Ant API</title>
 </head>
 <body>
 Redirecting to <a href="packages.html">Ant API ...</a>
 </body>
 </html>

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd>
 <!--NewPage-->
 <HTML>
 <HEAD>
 <!-- Generated by javadoc on Tue Aug 07 23:36:00 GMT+10:00 2001-->
 <TITLE>
 Ant API
 </TITLE>
 </HEAD>
 <FRAMESET cols="20%,80%">
 <FRAMESET rows="30%,70%">
 <FRAME src="overview-frame.html" name="packageListFrame">
 <FRAME src="allclasses-frame.html" name="packageFrame">
 </FRAMESET>
 <FRAME src="overview-summary.html" name="classFrame">
 </FRAMESET>
 <NOFRAMES>
 <H2>
 Frame Alert</H2>

 <P>
 This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client.
 <BR>
 Link to <A HREF="overview-summary.html">Non-frame version.</A></NOFRAMES>
 </HTML>
--- a/docs/manual/api/packages.html
+++ b/docs/manual/api/packages.html
@@ -1,10 +1,26 @@
 <html>
 <head>
 <title>Ant API</title>
 </head>
 <body>
 <b>Ant API has not been generated</b>
 </body>
 </html>
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd">
 <!--NewPage-->
 <HTML>
 <HEAD>
 <!-- Generated by javadoc on Tue Aug 07 23:36:00 GMT+10:00 2001 -->
 <TITLE>
 Ant API
 </TITLE>
 <LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
 </HEAD>
 <BODY BGCOLOR="white">

 <BR>

 <BR>

 <BR>
 <CENTER>
 The front page has been relocated.Please see:
 <BR>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Frame version</A>
 <BR>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="overview-summary.html">Non-frame version.</A></CENTER>

 </BODY>
 </HTML>