forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
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 GMT
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 -->



Mime
View raw message