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/02/09 10:57:50 UTC

svn commit: r153045 - in forrest/trunk/docs-author/content/xdocs: site.xml upgrading_07.xml

Author: crossley
Date: Wed Feb  9 01:57:47 2005
New Revision: 153045

URL: http://svn.apache.org/viewcvs?view=rev&rev=153045
Log:
Commence the "Upgrading to 0.7" doc.

Added:
    forrest/trunk/docs-author/content/xdocs/upgrading_07.xml   (with props)
Modified:
    forrest/trunk/docs-author/content/xdocs/site.xml

Modified: forrest/trunk/docs-author/content/xdocs/site.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/docs-author/content/xdocs/site.xml?view=diff&r1=153044&r2=153045
==============================================================================
--- forrest/trunk/docs-author/content/xdocs/site.xml (original)
+++ forrest/trunk/docs-author/content/xdocs/site.xml Wed Feb  9 01:57:47 2005
@@ -65,8 +65,8 @@
     </developers>
     
     <upgrading label="Upgrading">
+      <upgrading_07 label="Upgrading to 0.7" href="upgrading_07.html"/>
       <upgrading_06 label="Upgrading to 0.6" href="upgrading_06.html"/>
-      <upgrading_05 label="Upgrading to 0.5" href="upgrading_05.html"/>
     </upgrading>
   </documentation>
 

Added: forrest/trunk/docs-author/content/xdocs/upgrading_07.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/docs-author/content/xdocs/upgrading_07.xml?view=auto&rev=153045
==============================================================================
--- forrest/trunk/docs-author/content/xdocs/upgrading_07.xml (added)
+++ forrest/trunk/docs-author/content/xdocs/upgrading_07.xml Wed Feb  9 01:57:47 2005
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 2002-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd">
+<document> 
+  <header> 
+    <title>Upgrading to Apache Forrest 0.7</title> 
+  </header> 
+  <body> 
+    <section id="introduction">
+      <title>Introduction</title>
+      <p>
+      This page describes changes to Apache Forrest that affect people who are
+      upgrading to the 0.7 version.
+      If you have other issues, then please discuss on either the
+      <link href="ext:mail-lists/forrest-dev">dev</link> or
+      <link href="ext:mail-lists/forrest-user">user</link>
+      mailing lists.
+      As more experience is gained, this document will be updated.  
+      </p>
+      <p>
+      (If you are upgrading from a version prior to 0.6 then you may want
+      to see the notes for the <link href="site:upgrading_06">previous</link>
+      upgrade. However you should be fine with the notes from this 0.7 document.)
+      </p>
+    </section>
+
+    <section id="new">
+      <title>New Features</title>
+      <p>
+        The following list shows some of the key new features for Forrest 0.7
+        (for the full list of changes, see the
+        <link href="site:changes">change log</link>).
+      </p>
+      <ul>
+        <li>###</li>
+      </ul>
+    </section>
+
+    <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>
+    </section>
+
+    <section id="jdk14">
+      <title>Java JDK 1.4 is required</title>
+      <p>Java JDK 1.4 is required
+      </p>
+    </section>
+
+
+    <section id="tips">
+      <title>General upgrade tips</title>
+      <p>
+      Synchronise your project's skinconf.xml and forrest.properties files.
+      </p>
+      <p>
+      Take advantage of the separation of concerns. In a new workspace,
+      create a fresh
+      '<code>forrest seed</code>' site, then tweak its forrest.properties
+      and skinconf.xml until it reflects your old site.
+      When it is ready, replace your project's skinconf.xml and
+      forrest.properties files.
+      Any remaining issues would concern other aspects of your configuration,
+      such as site.xml and your actual content.
+      </p>
+    </section>
+
+    <section id="home">
+      <title>New location of $FORREST_HOME</title>
+      <p>
+      $FORREST_HOME is now the top-level of the distribution.
+      Also make sure PATH gets updated to use the new $FORREST_HOME/bin
+      </p>
+    </section>
+
+    <section>
+      <title>To be continued...</title>
+      <p>...as more issues are discovered/remembered :)  Please send feedback
+      to the
+      <link href="ext:mail-lists/forrest-dev">mailing list</link>.</p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/docs-author/content/xdocs/upgrading_07.xml
------------------------------------------------------------------------------
    svn:eol-style = native