Return-Path: 
 <svn-return-4184-apmail-forrest-svn-archive=forrest.apache.org@forrest.apache.org>
Delivered-To: apmail-forrest-svn-archive@www.apache.org
Received: (qmail 33304 invoked from network); 8 Nov 2005 05:32:41 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 8 Nov 2005 05:32:41 -0000
Received: (qmail 61257 invoked by uid 500); 8 Nov 2005 05:32:41 -0000
Delivered-To: apmail-forrest-svn-archive@forrest.apache.org
Received: (qmail 61223 invoked by uid 500); 8 Nov 2005 05:32:40 -0000
Mailing-List: contact svn-help@forrest.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:svn-help@forrest.apache.org>
list-unsubscribe: <mailto:svn-unsubscribe@forrest.apache.org>
List-Post: <mailto:svn@forrest.apache.org>
Reply-To: "Forrest Developers List" <dev@forrest.apache.org>
List-Id: <svn.forrest.apache.org>
Delivered-To: mailing list svn@forrest.apache.org
Received: (qmail 61212 invoked by uid 99); 8 Nov 2005 05:32:40 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 07 Nov 2005 21:32:40 -0800
X-ASF-Spam-Status: No, hits=-9.4 required=10.0
	tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194)
    by apache.org (qpsmtpd/0.29) with SMTP; Mon, 07 Nov 2005 21:32:34 -0800
Received: (qmail 33100 invoked by uid 65534); 8 Nov 2005 05:32:18 -0000
Message-ID: <20051108053218.33099.qmail@minotaur.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r331689 - in /forrest/branches/forrest_07_branch: main/
 site-author/ site-author/content/xdocs/docs_0_70/
 site-author/content/xdocs/docs_0_80/
Date: Tue, 08 Nov 2005 05:32:16 -0000
To: svn@forrest.apache.org
From: crossley@apache.org
X-Mailer: svnmailer-1.0.5
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Author: crossley
Date: Mon Nov  7 21:32:08 2005
New Revision: 331689

URL: http://svn.apache.org/viewcvs?rev=331689&view=rev
Log:
Add new Ant targets for cleaning the project workspace. Doing 'forrest clean-site'
will remove the contents of the project's generated documents directory.
Doing 'forrest clean-work' will remove the project's work directories
(usually build/tmp and build/webapp which include the Cocoon cache and the Cocoon logs).
Doing 'forrest clean' will remove both sections.

Modified:
    forrest/branches/forrest_07_branch/main/forrest.build.xml
    forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/faq.xml
    forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/upgrading_07.xml
    forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml
    forrest/branches/forrest_07_branch/site-author/status.xml

Modified: forrest/branches/forrest_07_branch/main/forrest.build.xml
URL: http://svn.apache.org/viewcvs/forrest/branches/forrest_07_branch/main/forrest.build.xml?rev=331689&r1=331688&r2=331689&view=diff
==============================================================================
--- forrest/branches/forrest_07_branch/main/forrest.build.xml (original)
+++ forrest/branches/forrest_07_branch/main/forrest.build.xml Mon Nov  7 21:32:08 2005
@@ -1,6 +1,6 @@
 <?xml version="1.0"?>
 <!--
-  Copyright 2002-2004 The Apache Software Foundation or its licensors,
+  Copyright 2002-2005 The Apache Software Foundation or its licensors,
   as applicable.
 
   Licensed under the Apache License, Version 2.0 (the "License");
@@ -394,14 +394,18 @@
        param: location to clean ${project.webapp}
        param: file to clean ${project.brokenlinkfile}
        =============================================================== -->
-  <target name="clean" depends="init-props" description="* Clean all directories and files generated during the build">
+  <target name="clean-site" depends="init-props"
+      description="* Clean the project generated documents directory">
     <delete failonerror="false" dir="${project.site-dir}"/>
+    <delete failonerror="false" file="${project.brokenlinkfile}"/>
+  </target>
+  <target name="clean-work" depends="init-props"
+      description="* Clean the project work directories">
     <delete failonerror="false" dir="${project.temp-dir}"/>
     <delete failonerror="false" dir="${project.webapp}"/>
-    <delete failonerror="false" file="${project.brokenlinkfile}"/>
   </target>
-  <target name="clean-site" depends="clean"/>
-
+  <target name="clean" depends="clean-site,clean-work"
+      description="* Clean all directories and files generated during the build"/>
 
 <!-- ***************************************************************** -->
 <!-- ***************************************************************** -->

Modified: forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/faq.xml
URL: http://svn.apache.org/viewcvs/forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/faq.xml?rev=331689&r1=331688&r2=331689&view=diff
==============================================================================
--- forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/faq.xml (original)
+++ forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/faq.xml Mon Nov  7 21:32:08 2005
@@ -360,13 +360,19 @@
       </answer>
     </faq>
     <faq id="cleanSite">
-      <question> How can I make Forrest properly clean up the build/site-directory? </question>
+      <question> How to make Forrest clean up the project build directories? </question>
       <answer>
-        <p>Forrest for performance reasons doesn't clean out the build/site-directory each time you
-          compile your project. This usually doesn't matter during development but might become a
-          problem in a production environment.</p>
-        <p>To ensure a clean build call 'forrest clean site' instead of just 'forrest' so Forrest
-          will delete all build directories before creating new content. </p>
+        <p>
+          By default Forrest does not clean its build directories in the project
+          workspaces. This enables Cocoon to use its disk cache to speed up
+          successive runs of forrest.
+        </p>
+        <p>
+        Doing 'forrest clean-site' will remove the contents of the project's
+        generated documents directory. Doing 'forrest clean-work' will remove the
+        project's work directories (usually build/tmp and build/webapp which
+        includes the Cocoon cache). Doing 'forrest clean' will remove both.
+        </p>
       </answer>
     </faq>
     <faq id="i18n">

Modified: forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/upgrading_07.xml
URL: http://svn.apache.org/viewcvs/forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/upgrading_07.xml?rev=331689&r1=331688&r2=331689&view=diff
==============================================================================
--- forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/upgrading_07.xml (original)
+++ forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_70/upgrading_07.xml Mon Nov  7 21:32:08 2005
@@ -58,9 +58,9 @@
 
     <section id="clean">
       <title>Run a clean target after upgrade</title>
-      <p>To avoid any issue with old classes being loaded, run a
-        '<code>forrest clean</code>' in your project directory, after you
-        upgraded to this version.
+      <p>
+        Do 'forrest clean-work' in each of your projects. This also removes
+        the old Cocoon disk cache.
       </p>
     </section>
 

Modified: forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml
URL: http://svn.apache.org/viewcvs/forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml?rev=331689&r1=331688&r2=331689&view=diff
==============================================================================
--- forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml (original)
+++ forrest/branches/forrest_07_branch/site-author/content/xdocs/docs_0_80/upgrading_08.xml Mon Nov  7 21:32:08 2005
@@ -62,9 +62,9 @@
 
     <section id="clean">
       <title>Run a clean target after upgrade</title>
-      <p>To avoid any issue with old classes being loaded, run a
-        '<code>forrest clean</code>' in your project directory, after you
-        upgraded to this version.
+      <p>
+        Do 'forrest clean-work' in each of your projects. This also removes
+        the old Cocoon disk cache.
       </p>
     </section>
 

Modified: forrest/branches/forrest_07_branch/site-author/status.xml
URL: http://svn.apache.org/viewcvs/forrest/branches/forrest_07_branch/site-author/status.xml?rev=331689&r1=331688&r2=331689&view=diff
==============================================================================
--- forrest/branches/forrest_07_branch/site-author/status.xml (original)
+++ forrest/branches/forrest_07_branch/site-author/status.xml Mon Nov  7 21:32:08 2005
@@ -131,6 +131,27 @@
       </action>
       
     </release>
+    <release version="0.7.1-dev" date="not yet released">
+      <notes>
+        <section>
+          <title>apache-forrest-0.7.1-dev</title>
+          <p>Will only be released if absolutely necessary</p>
+        </section>
+      </notes>
+      <action dev="DC" type="add" context="docs">
+<!-- Please keep this action at the top -->
+        Added document to facilitate
+        <link href="site:v0.70//upgrading_07">upgrading to v0.7</link>
+      </action>
+      <action dev="DC" type="update" context="code" importance="high">
+        Added new "clean" targets. Doing 'forrest clean-site' will remove
+        the contents of the project's generated documents directory.
+        Doing 'forrest clean-work' will remove the project's work directories
+        (usually build/tmp and build/webapp which include the Cocoon cache
+        and the Cocoon logs).
+        Doing 'forrest clean' will remove both sections.
+      </action>
+    </release>
     <release version="0.7" date="2005-06-23">
       <action dev="DC" type="add" context="docs">
 <!-- Please keep this action at the top -->