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:32:16 UTC
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/
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 -->