You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2005/11/08 06:30:48 UTC

svn commit: r331686 - in /forrest/trunk: main/ site-author/ site-author/content/xdocs/docs_0_70/ site-author/content/xdocs/docs_0_80/

Author: crossley
Date: Mon Nov  7 21:30:37 2005
New Revision: 331686

URL: http://svn.apache.org/viewcvs?rev=331686&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/trunk/main/forrest.build.xml
    forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml
    forrest/trunk/site-author/content/xdocs/docs_0_70/upgrading_07.xml
    forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
    forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml
    forrest/trunk/site-author/status.xml

Modified: forrest/trunk/main/forrest.build.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/main/forrest.build.xml?rev=331686&r1=331685&r2=331686&view=diff
==============================================================================
--- forrest/trunk/main/forrest.build.xml (original)
+++ forrest/trunk/main/forrest.build.xml Mon Nov  7 21:30:37 2005
@@ -398,13 +398,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/trunk/site-author/content/xdocs/docs_0_70/faq.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml?rev=331686&r1=331685&r2=331686&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml Mon Nov  7 21:30:37 2005
@@ -360,13 +360,20 @@
       </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
+        include the Cocoon cache and the Cocoon logs).
+        Doing 'forrest clean' will remove both sections.
+        </p>
       </answer>
     </faq>
     <faq id="i18n">

Modified: forrest/trunk/site-author/content/xdocs/docs_0_70/upgrading_07.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_70/upgrading_07.xml?rev=331686&r1=331685&r2=331686&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_70/upgrading_07.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_70/upgrading_07.xml Mon Nov  7 21:30:37 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/trunk/site-author/content/xdocs/docs_0_80/faq.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml?rev=331686&r1=331685&r2=331686&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml Mon Nov  7 21:30:37 2005
@@ -391,13 +391,20 @@
       </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
+        include the Cocoon cache and the Cocoon logs).
+        Doing 'forrest clean' will remove both sections.
+        </p>
       </answer>
     </faq>
     <faq id="i18n">

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml?rev=331686&r1=331685&r2=331686&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml Mon Nov  7 21:30:37 2005
@@ -62,12 +62,8 @@
 
     <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>
       <p>
-        Also do 'forrest clean' in each of your projects. This also removes
+        Do 'forrest clean-work' in each of your projects. This also removes
         the old Cocoon disk cache.
       </p>
     </section>

Modified: forrest/trunk/site-author/status.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/status.xml?rev=331686&r1=331685&r2=331686&view=diff
==============================================================================
--- forrest/trunk/site-author/status.xml (original)
+++ forrest/trunk/site-author/status.xml Mon Nov  7 21:30:37 2005
@@ -131,6 +131,15 @@
         <link href="site:v0.80//upgrading_08">upgrading to v0.8</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>
+  
       <action context="code" type="update" dev="DC" due-to="Sjur N. Moshagen"
           fix-for="FOR-581,FOR-720">
         Fixed and enhanced the Forrest plugin for the XMLmind XML Editor at tools/xxe
@@ -154,8 +163,8 @@
       </action>
 
       <action context="code" type="add" dev="DC" due-to="Pier Fumagalli">
-        Added Validation transformer to enable RELAX NG validation
-        with Jing.
+        Added Validation transformer to enable RELAX NG validation and
+        W3C XML Schema validation using Jing and Xerces.
         See <link
           href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=112598308027438">forrest-dev
           discussion</link>.
@@ -238,6 +247,27 @@
         See <link href="site:v0.80//locationmap">locationmap docs</link> for more information.
       </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">