Return-Path: Delivered-To: apmail-ant-notifications-archive@locus.apache.org Received: (qmail 5659 invoked from network); 1 Jul 2008 15:13:27 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 1 Jul 2008 15:13:27 -0000 Received: (qmail 43613 invoked by uid 500); 1 Jul 2008 15:13:28 -0000 Delivered-To: apmail-ant-notifications-archive@ant.apache.org Received: (qmail 43592 invoked by uid 500); 1 Jul 2008 15:13:28 -0000 Mailing-List: contact notifications-help@ant.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ant.apache.org Delivered-To: mailing list notifications@ant.apache.org Received: (qmail 43582 invoked by uid 99); 1 Jul 2008 15:13:28 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 01 Jul 2008 08:13:28 -0700 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 01 Jul 2008 15:12:46 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 2EAD32388A0A; Tue, 1 Jul 2008 08:13:06 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r673096 - /ant/sandbox/antlibs/fscache/trunk/docs/index.html Date: Tue, 01 Jul 2008 15:13:06 -0000 To: notifications@ant.apache.org From: mbenson@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20080701151306.2EAD32388A0A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: mbenson Date: Tue Jul 1 08:13:05 2008 New Revision: 673096 URL: http://svn.apache.org/viewvc?rev=673096&view=rev Log: elaborate somewhat so Stefan knows what I'm talking about ;) Modified: ant/sandbox/antlibs/fscache/trunk/docs/index.html Modified: ant/sandbox/antlibs/fscache/trunk/docs/index.html URL: http://svn.apache.org/viewvc/ant/sandbox/antlibs/fscache/trunk/docs/index.html?rev=673096&r1=673095&r2=673096&view=diff ============================================================================== --- ant/sandbox/antlibs/fscache/trunk/docs/index.html (original) +++ ant/sandbox/antlibs/fscache/trunk/docs/index.html Tue Jul 1 08:13:05 2008 @@ -24,10 +24,24 @@

Introduction

-

This is a library of tasks/types to allow arbitrary resources to be, - as transparently as possible, cached to the filesystem for use with - tasks that require file resources, e.g. Ant's core <unzip> and - <javac> tasks among others.

+

This is a library of tasks/types to allow arbitrary resources to be, as + transparently as possible, cached to the filesystem for use with tasks that + require file resources: for example, many of the tasks that work with archives. + You might need access to the contents of a JAR resource located at a given URL, + by means of the unzip + task. Alternatively, you might simply need access to a particular entry in the JAR as a + zipentry. + Long story short, the fscache Antlib allows you to expose a resource of + arbitrary origin as a filesystem resource, and provides options which can be used or + omitted to control the generation of the cache. In most cases accepting + default options will cause temporary files to be generated on-demand in your system + ${java.io.tmpdir} temp directory, and these files will be marked for deletion + on VM exit. Other possible applications of this functionality include compiling + Java source found e.g. in an archive using the + javac task, or accessing + nested archive resources by caching multiple levels from an outer archive file, + e.g. reading a JAR resource from a WAR or, indirectly, an EAR file. +

Requirements