Return-Path: 
 <ant-user-return-10369-apmail-jakarta-ant-user-archive=jakarta.apache.org@jakarta.apache.org>
Delivered-To: apmail-jakarta-ant-user-archive@jakarta.apache.org
Received: (qmail 71982 invoked by uid 500); 18 Jul 2001 14:02:01 -0000
Mailing-List: contact ant-user-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
List-Post: <mailto:ant-user@jakarta.apache.org>
List-Help: <mailto:ant-user-help@jakarta.apache.org>
List-Unsubscribe: <mailto:ant-user-unsubscribe@jakarta.apache.org>
List-Subscribe: <mailto:ant-user-subscribe@jakarta.apache.org>
Reply-To: ant-user@jakarta.apache.org
Delivered-To: mailing list ant-user@jakarta.apache.org
Received: (qmail 71971 invoked from network); 18 Jul 2001 14:02:00 -0000
Message-ID: <3B5596D3.D474B6F0@healthlanguage.com>
Date: Wed, 18 Jul 2001 08:01:55 -0600
From: "Larry V. Streepy, Jr." <streepy@healthlanguage.com>
Organization: Health Language, Inc.
X-Mailer: Mozilla 4.76 [en] (Windows NT 5.0; U)
X-Accept-Language: en
MIME-Version: 1.0
To: ant-user@jakarta.apache.org
Subject: Re: Conditional javadocs build
References: <753866CAB183D211883F0090271F46C20589DC1F@mailhost.armature.com>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N

Mark Hewitt wrote:
> 
> Is it possible to tell the javadoc task to execute only if there
> have been any changes to the packages over which it is running?
> 
> For some of our projects, the resources required to generate the
> javadocs are rate limiting, and while I can conditionalise the
> compilation, there does not seem to be a well defined means of
> doing the same for javadoc.

It's not exactly perfect, but the fragment below works well enough
for us.  You can probably tweak it so it works for you.


  <!-- ==================================================================== -->
  <!-- INTERNAL: Check to see if any source files are newer than the doc    -->
  <!-- ==================================================================== -->
  <target name="customer-javadoc-check" depends="prepare-build">
    <uptodate property="customer.javadoc.notrequired" targetfile="${build.customer.doc}/packages.html" >
        <srcfiles dir= "${src.dir}" includes="**/*.java"/>
    </uptodate>
  </target>

  <!-- ==================================================================== -->
  <!-- Generate the javadoc for the deployed (customer visible) API's       -->
  <!-- ==================================================================== -->
  <target name="customer-javadoc"
          depends="prepare-build,customer-javadoc-check"
          unless="customer.javadoc.notrequired"
          description="Generate the Customer (deployed) javadoc">

    <javadoc destdir="${build.customer.doc}"
             sourcepath="${src.dir}"
             classpath="${base.path}"
             header="${name}"
             maxmemory="96m"
             bottom="${copyright}"
             packagenames="com.cyberplus.le.ejb,
                           com.cyberplus.le.ejb.error,
                           com.cyberplus.util,
                           com.cyberplus.le.client.tools,
                           com.cyberplus.le.server.web.servlet"/>
  </target>

-- 
Larry V. Streepy, Jr.
Chief Technical Officer and VP of Engineering

Health Language, Inc.  -- "We speak the language of healthcare"

970/626-5028 (office)           mailto:streepy@healthlanguage.com
970/626-4425 (fax)              http://www.healthlanguage.com