forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r694614 - in /forrest/trunk/site-author: content/xdocs/docs_0_90/upgrading_09.xml content/xdocs/site.xml status.xml
Date Fri, 12 Sep 2008 06:09:54 GMT
Author: crossley
Date: Thu Sep 11 23:09:53 2008
New Revision: 694614

URL: http://svn.apache.org/viewvc?rev=694614&view=rev
Log:
Added notes about our Cocoon upgrade.
Issue: FOR-955

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml
    forrest/trunk/site-author/content/xdocs/site.xml
    forrest/trunk/site-author/status.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml?rev=694614&r1=694613&r2=694614&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.xml Thu Sep 11 23:09:53
2008
@@ -51,6 +51,10 @@
         for each plugin.
       </p>
       <ul>
+        <li>
+          Our packaged Apache Cocoon is upgraded, along with various other
+          important supporting products such as Apache Xerces and Apache Xalan, etc.
+        </li>
         <li>[Placeholder]</li>
       </ul>
       <p>
@@ -60,6 +64,65 @@
         <a href="site:status-themes">Status of Themes: Skins and Dispatcher</a>.
       </p>
     </section>
+    <section id="cocoon">
+      <title>Notes about Cocoon version</title>
+      <p>
+        Our packaged version of Apache Cocoon has been upgraded to use the
+        latest version of their stable 2.1 branch. This is a major step forward
+        for Forrest. It enables us to use a reliable and up-to-date Cocoon.
+        Forrest developers can again participate at Cocoon to fix issues or
+        develop new blocks. A number of major performance issues are already
+        fixed in this version.
+      </p>
+      <p>
+        In previous versions of Forrest we were using a development version of
+        Cocoon trunk (i.e. 2.2). A number of things happened which caused us to
+        fall out of synchronisation with Cocoon. They started using Maven as a
+        build system, which took a long time to settle down. In turn that meant
+        that Apache Gump could not perform continuous integration, which shut
+        Forrest off. At the same time Cocoon trunk was making technical advances
+        which changed some of the ways that Forrest interacts with Cocoon. In
+        particular the command-line interface which Forrest uses to build a
+        complete static site.
+        See other notes via <a href="http://issues.apache.org/jira/browse/FOR-1017">FOR-1017</a>.
+      </p>
+      <p>
+        Cocoon-2.1 is closer to our stalled version of Cocoon-2.2 than the
+        current head of Cocoon-2.2 trunk.
+      </p>
+      <p>
+        Note that this move does not preclude us from future updates to other
+        versions of Cocoon or even to another xml processing framework.
+      </p>
+      <p>
+        If you want to use your own version of Cocoon-2.1, for example to add
+        another Cocoon Block or to enhance a particular existing block, then
+        see the notes in the <code>$FORREST_HOME/etc/cocoon_upgrade</code>
+        directory.
+      </p>
+
+      <section id="cocoon-upgrade">
+        <title>Cocoon upgrade issues</title>
+        <p>
+          There are only two minor issues for those upgrading from the previous
+          version of Forrest:
+        </p>
+        <p>
+          When you first use this in your existing projects, there will probably
+          be a message about a certain cache item. On the second run all is well.
+          A way to avoid that would be to do 'forrest clean-work' in each of
+          your projects to remove the old Cocoon cache.
+        </p>
+        <p>
+          Our previous version of Cocoon had a facility called "Running modes"
+          which enabled one set of a minimal group of properties for development
+          and a different set for production. This is not available in Cocoon-2.1
+          version. If you were using this feature, then simply move your defined
+          properties into the <code>main/webapp/WEB-INF/properties/core.properties</code>
+          file.
+        </p>
+      </section>
+    </section>
     <section id="missing-symbols">
       <title>Missing project symbols file in some projects</title>
       <p>Users of 0.8, and developers with older 0.9-dev, who based their sites on
'forrest seed-basic' rather than 'forrest seed-sample' will be affected by FOR-1075. There
was a partially implemented xml catalog with missing symbols file.
@@ -77,7 +140,7 @@
         <code>cp $FORREST_HOME/main/fresh-site/src/documentation/resources/schema/symbols-project-v10.ent
$PROJECT/src/documentation/resources/schema/symbols-project-v10.ent</code>
       </p>
       <p>
-        This "project symbols" ability using xml entities is useful in two ways. 
+        This "project symbols" ability using xml entities is useful in two ways.
         To provide commons symbols, words, and phrases, in your source documents
         (added in v0.8 - <a href="site:faq/xml-entities">FAQ</a>).
         To configure some Cocoon sitemap components
@@ -115,7 +178,7 @@
     <section id="project-sitemap">
       <title>Remove project sitemap if not necessary</title>
       <p>
-        It has come to our attention that some people have a 
+        It has come to our attention that some people have a
         <a href="site:project-sitemap">project sitemap</a>
         even though they are not using it. Such un-necessary sitemaps should be
         removed to avoid maintenance issues.

Modified: forrest/trunk/site-author/content/xdocs/site.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/site.xml?rev=694614&r1=694613&r2=694614&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Thu Sep 11 23:09:53 2008
@@ -246,7 +246,9 @@
 <!-- FIXME: Needed to avoid moving files -->
       <catalog href="catalog.html"/>
       <project-sitemap href="project-sitemap.html"/>
-      <upgrading_09 href="upgrading_09.html"/>
+      <upgrading_09 href="upgrading_09.html">
+        <cocoon href="#cocoon"/>
+      </upgrading_09>
 <!-- FIXME: i don't understand what the previous FIXME means. Why do we need those entries
without labels? -->
 <!-- Insert all instructional documentation here -->
       <your-project label="Using Forrest" href="your-project.html">

Modified: forrest/trunk/site-author/status.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/status.xml?rev=694614&r1=694613&r2=694614&view=diff
==============================================================================
--- forrest/trunk/site-author/status.xml (original)
+++ forrest/trunk/site-author/status.xml Thu Sep 11 23:09:53 2008
@@ -151,6 +151,17 @@
         Added document to facilitate
         <link href="site:upgrading_09">upgrading to v0.9</link>
       </action>
+<!-- 2008-09 -->
+      <action context="code" type="update" dev="TS, DC" fixes-bug="FOR-955,FOR-1017" importance="high">
+        Our packaged version of Apache Cocoon has been upgraded to use the
+        latest version of their stable 2.1 branch. This is a major step forward
+        for Forrest. It enables us to use a reliable and up-to-date Cocoon.
+        Forrest developers can again participate at Cocoon to fix issues or
+        develop new blocks. A number of major performance issues are already
+        fixed in this version. Also upgraded various other important supporting
+        products such as Apache Xerces and Apache Xalan, etc.
+        See <link href="site:upgrading_09/cocoon">upgrading notes</link>.
+      </action>
 <!-- 2008-08 -->
       <action context="docs" type="add" dev="DC" fixes-bug="FOR-814" due-to="Carlos Tejo">
         Added example of using XInclude to the 'forrest seed sample' site.



Mime
View raw message