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/21 03:30:49 UTC
svn commit: r154612 - forrest/site/docs/dev/upgrading_07.html
forrest/site/docs/dev/upgrading_07.pdf
Author: crossley
Date: Sun Feb 20 18:30:47 2005
New Revision: 154612
URL: http://svn.apache.org/viewcvs?view=rev&rev=154612
Log:
Add new doc "Upgrading to 0.7"
Added:
forrest/site/docs/dev/upgrading_07.html (with props)
forrest/site/docs/dev/upgrading_07.pdf (with props)
Added: forrest/site/docs/dev/upgrading_07.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs/dev/upgrading_07.html?view=auto&rev=154612
==============================================================================
--- forrest/site/docs/dev/upgrading_07.html (added)
+++ forrest/site/docs/dev/upgrading_07.html Sun Feb 20 18:30:47 2005
@@ -0,0 +1,409 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.6">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Upgrading to Apache Forrest 0.7</title>
+<link type="text/css" href="skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
+<link type="text/css" href="skin/profile.css" rel="stylesheet">
+<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://forrest.apache.org/">forrest</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="images/apache-forrest.png" title="The Apache Software Foundation"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Search
+ +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google:');" value="Search the site with google:" size="25" name="q" id="query" type="text">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../index.html">Welcome</a>
+</li>
+<li>
+<a class="base-not-selected" href="../contrib.html">Project</a>
+</li>
+<li class="current">
+<a class="base-selected" href="index.html">0.7-dev Documentation</a>
+</li>
+<li>
+<a class="base-not-selected" href="howto/index.html">How-To</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript" language="JavaScript"><!--
+ document.write("Published: " + document.lastModified);
+ // --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Documentation</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a title="" href="index.html">Index</a>
+</div>
+<div class="menuitem">
+<a title="" href="faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a title="" href="changes.html">Changes</a>
+</div>
+<div class="menuitem">
+<a title="" href="todo.html">Todo</a>
+</div>
+<div class="menuitem">
+<a title="" href="your-project.html">Using Forrest</a>
+</div>
+<div class="menuitem">
+<a title="" href="validation.html">XML Validation</a>
+</div>
+<div class="menuitem">
+<a title="" href="linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a title="" href="searching.html">Searching</a>
+</div>
+<div class="menuitem">
+<a title="" href="skins.html">Default Skins</a>
+</div>
+<div class="menuitem">
+<a title="" href="skin-package.html">Skin Packages</a>
+</div>
+<div class="menuitem">
+<a title="" href="leather.html">Leather-skin</a>
+</div>
+<div class="menuitem">
+<a title="" href="plugins/usingPlugins.html">Plugins</a>
+</div>
+<div class="menuitem">
+<a title="" href="forrest-contract.html">Our Contract</a>
+</div>
+<div class="menuitem">
+<a title="" href="compliance.html">Standards Compliance</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.15', 'skin/')" id="menu_1.1.15Title" class="menutitle">Advanced Topics</div>
+<div id="menu_1.1.15" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="build.html">Building Forrest</a>
+</div>
+<div class="menuitem">
+<a title="" href="catalog.html">Using DTD Catalogs</a>
+</div>
+<div class="menuitem">
+<a title="" href="sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a title="" href="project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a title="" href="plugins/pluginInfrastructure.html">Plugin Infrastructure</a>
+</div>
+<div class="menuitem">
+<a title="" href="cap.html">Sourcetype Action</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.16', 'skin/')" id="menu_selected_1.1.16Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Upgrading</div>
+<div id="menu_selected_1.1.16" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Upgrading to 0.7</div>
+</div>
+<div class="menuitem">
+<a title="" href="upgrading_06.html">Upgrading to 0.6</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">SubProjects</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="forrestbar.html">ForrestBar</a>
+</div>
+<div class="menuitem">
+<a title="" href="forrestbot.html">Forrestbot</a>
+</div>
+<div class="menuitem">
+<a title="" href="forrestbot-web-interface.html">Forrestbot Webapp</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', 'skin/')" id="menu_1.3Title" class="menutitle">Reference docs</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.3.1', 'skin/')" id="menu_1.3.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.3.1" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a title="" href="document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a title="" href="document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.2', 'skin/')" id="menu_1.3.2Title" class="menutitle">Doc samples</div>
+<div id="menu_1.3.2" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="document-v13.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a title="" href="document-v20.html">document-v20</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Older Docs</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a title="" href="primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a title="" href="libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a title="" href="dreams.html">Dream list</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div id="skinconf-txtlink"></div>
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="upgrading_07.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">
+ Font size:
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>Upgrading to Apache Forrest 0.7</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#introduction">Introduction</a>
+</li>
+<li>
+<a href="#new">New Features</a>
+</li>
+<li>
+<a href="#clean">Run a clean target after upgrade</a>
+</li>
+<li>
+<a href="#jdk14">Java JDK 1.4 is required</a>
+</li>
+<li>
+<a href="#tips">General upgrade tips</a>
+</li>
+<li>
+<a href="#home">New location of $FORREST_HOME</a>
+</li>
+<li>
+<a href="#To+be+continued...">To be continued...</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000D"></a><a name="introduction"></a>
+<h2 class="underlined_10">Introduction</h2>
+<div class="section">
+<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
+ <a href="http://forrest.apache.org/mail-lists.html#forrest-dev">dev</a> or
+ <a href="http://forrest.apache.org/mail-lists.html#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.6 then you may want
+ to see the notes for the <a href="upgrading_06.html">previous</a>
+ upgrade. However you should be fine with the notes from this 0.7 document.)
+ </p>
+</div>
+
+
+<a name="N10026"></a><a name="new"></a>
+<h2 class="underlined_10">New Features</h2>
+<div class="section">
+<p>
+ The following list shows some of the key new features for Forrest 0.7
+ (for the full list of changes, see the
+ <a href="changes.html">change log</a>).
+ </p>
+<ul>
+
+<li>###</li>
+
+</ul>
+</div>
+
+
+<a name="N1003A"></a><a name="clean"></a>
+<h2 class="underlined_10">Run a clean target after upgrade</h2>
+<div class="section">
+<p>To avoid any issue with old classes being loaded, run a
+ '<span class="codefrag">forrest clean</span>' in your project directory, after you
+ upgraded to this version.
+ </p>
+</div>
+
+
+<a name="N10047"></a><a name="jdk14"></a>
+<h2 class="underlined_10">Java JDK 1.4 is required</h2>
+<div class="section">
+<p>Java JDK 1.4 is required
+ </p>
+</div>
+
+
+
+<a name="N10051"></a><a name="tips"></a>
+<h2 class="underlined_10">General upgrade tips</h2>
+<div class="section">
+<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
+ '<span class="codefrag">forrest seed</span>' 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>
+</div>
+
+
+<a name="N10061"></a><a name="home"></a>
+<h2 class="underlined_10">New location of $FORREST_HOME</h2>
+<div class="section">
+<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>
+</div>
+
+
+<a name="N1006B"></a><a name="To+be+continued..."></a>
+<h2 class="underlined_10">To be continued...</h2>
+<div class="section">
+<p>...as more issues are discovered/remembered :) Please send feedback
+ to the
+ <a href="http://forrest.apache.org/mail-lists.html#forrest-dev">mailing list</a>.</p>
+</div>
+
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright © 2002-2005 The Apache Software Foundation.</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: forrest/site/docs/dev/upgrading_07.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/docs/dev/upgrading_07.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs/dev/upgrading_07.pdf?view=auto&rev=154612
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/docs/dev/upgrading_07.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf