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/06/15 15:27:08 UTC

svn commit: r190747 - /forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml

Author: crossley
Date: Wed Jun 15 06:27:06 2005
New Revision: 190747

URL: http://svn.apache.org/viewcvs?rev=190747&view=rev
Log:
Add the beginning of the upgrading_08 document.

Added:
    forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml   (with props)

Added: 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=190747&view=auto
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml (added)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml Wed Jun 15 06:27:06 2005
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 2002-2004 The Apache Software Foundation or its licensors,
+  as applicable.
+
+  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 V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+<document> 
+  <header> 
+    <title>Upgrading to Apache Forrest 0.8-dev</title> 
+  </header> 
+  <body> 
+    <section id="introduction">
+      <title>Introduction</title>
+<note>
+This is the <strong>development</strong> version of Apache Forrest which can
+be obtained from the Subversion repository or from a code snapshot.
+See the notes for obtaining and <a href="site:v0.70//build">Building Forrest</a>.
+</note>
+      <p>
+      This page describes some changes to Apache Forrest that affect people who are
+      upgrading to the 0.8-dev version.
+      If you have other issues, then please discuss on either the
+      <a href="site:mail-lists/forrest-dev">dev</a> or
+      <a href="site:mail-lists/forrest-user">user</a>
+      mailing lists.
+      As more experience is gained, this document will be updated.  
+      </p>
+      <p>
+      (If you are upgrading from a version prior to 0.7 then you will need
+      to see the notes for the <a href="site:v0.60//upgrading_06">previous</a>
+      upgrade.)
+      </p>
+    </section>
+
+    <section id="new">
+      <title>New Features</title>
+      <p>
+        The following list shows some of the key new features
+        (for the full list of changes, see the
+        <a href="site:changes">change log</a>).
+      </p>
+      <ul>
+        <li></li>
+      </ul>
+      <p>
+        As usual, do a "forrest seed site" in a new directory and compare the
+        forrest.properties and skinconf.xml with that of your project.
+      </p>
+    </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="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>
+      <title>To be continued...</title>
+      <p>...as more issues are discovered/remembered :)  Please send feedback
+      to the
+      <a href="site:mail-lists/forrest-dev">mailing list</a>.</p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/site-author/content/xdocs/docs_0_80/upgrading_08.xml
------------------------------------------------------------------------------
    svn:eol-style = native