Return-Path: <jmcaine@alum.rpi.edu>
Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm
Delivered-To: mailing list ant-dev@jakarta.apache.org
Received: (qmail 52661 invoked from network); 1 Dec 2000 18:17:25 -0000
Received: from mailout3-0.nyroc.rr.com (24.92.226.118)
  by locus.apache.org with SMTP; 1 Dec 2000 18:17:25 -0000
Received: from gretchen (cm-24-25-153-251.nycap.rr.com [24.25.153.251])
	by mailout3-0.nyroc.rr.com (8.9.3/8.9.3) with SMTP id NAA23583
	for <ant-dev@jakarta.apache.org>; Fri, 1 Dec 2000 13:05:25 -0500 (EST)
From: "J. Michael Caine" <jmcaine@alum.rpi.edu>
To: <ant-dev@jakarta.apache.org>
Subject: "include"
Date: Fri, 1 Dec 2000 13:34:17 -0800
Message-ID: <000101c05bde$75664d80$fb991918@SPECTAURISSW>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Priority: 3 (Normal)
X-MSMail-Priority: Normal
X-Mailer: Microsoft Outlook 8.5, Build 4.71.2173.0
Importance: Normal
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2314.1300
X-Spam-Rating: locus.apache.org 1.6.2 0/1000/N

hi.  i just downloaded ant a couple of days ago.  i quite like it!

i have a number of projects that follow a pretty well-defined paradigm, so
i'm using a template.xml file to "factor out" commonalities in the project
build.xml files.  i essentially "include" this template using the <ant> task
(see example below).

this is a little redundant (a target like [template/init] is entered twice)
and a bit awkward.  could it be worth considering a tag called <include>,
under <project> and parallel with <target>?  it could be placed above all of
the <target>s for a given project and would effectively "include" all of the
targets in the included .xml file.

currently, my template looks something like:

<project name="template" default="compile" basedir="/development">
  <target name="init">
    <tstamp/>
    <property name="sources" value="${basedir}/sources"/>
    <property name="builds" value="${basedir}/builds"/>
    <property name="distributions" value="${basedir}/distributions"/>
    <property name="distjardir" value="${basedir}/temp/distjar"/>
    <property name="jarexclude" value="**/*.properties,**/*.policy"/>
    <property name="rootdistdir"
value="${distributions}/${project}${version}"/>
    <property name="distdir"
value="${distributions}/${project}${version}/${project}"/>
    <property name="docdir" value="${distdir}/${project}/doc"/>
  </target>

  <target name="compile" depends="init">
    <mkdir dir="${builds}"/>
    <javac srcdir="${sources}" destdir="${builds}"
     includes="${project}/**" excludes="${project}/*.xml"/>
  </target>

  <target name="dist" depends="compile">
    <mkdir dir="${distjardir}"/>
    <copydir src="${builds}" dest="${distjardir}" includes="${project}/**"/>
    <mkdir dir="${distdir}"/>
    <jar jarfile="${distdir}/${project}.jar" basedir="${distjardir}"
     excludes="${jarexclude}"/>
    <copydir src="${distjardir}" dest="${rootdistdir}"
includes="${jarexclude}"/>
  </target>

  <target name="doc" depends="init">
    <mkdir dir="${docdir}"/>
    <javadoc sourcepath="${sources}" destdir="${docdir}"
     packagenames="${project}.*"/>
  </target>

  <target name="clean" depends="init">
    <deltree dir="${builds}/${project}" />
    <deltree dir="${distjardir}" />
    <deltree dir="${rootdistdir}" />
  </target>
</project>

------------------------------------------------
then project build.xml's look something like:
------------------------------------------------

<project name="adapted" default="dist" basedir="/development">

  <target name="init">
    <property name="project" value="adapted"/>
    <property name="version" value="1.0"/>
    <deltree dir="${basedir}/temp"/>
  </target>

  <target name="compile" depends="init">
    <ant antfile="${basedir}/template.xml" dir="${basedir}"
target="compile"/>
  </target>

  <target name="dist" depends="compile">
    <ant antfile="${basedir}/template.xml" dir="${basedir}" target="dist"/>
  </target>

  <target name="doc" depends="compile">
    <ant antfile="${basedir}/template.xml" dir="${basedir}" target="doc"/>
  </target>

  <target name="clean" depends="init">
    <ant antfile="${basedir}/template.xml" dir="${basedir}" target="clean"/>
  </target>

</project>

------------------------------------------------
------------------------------------------------

<project name="jmc" default="dist" basedir="/development">

  <target name="init">
    <property name="project" value="jmc"/>
    <property name="version" value="1.0"/>
    <property name="builds" value="${basedir}/builds"/>
    <deltree dir="${basedir}/temp"/>
  </target>
...
  <target name="rmic" depends="compile">
    <rmic base="${builds}" classname="${project}.db.remote.DBI"/>
  </target>

  <target name="dist" depends="rmic">
    <ant antfile="${basedir}/template.xml" dir="${basedir}" target="dist"/>
  </target>
...
</project>