Google Git
Sign in
apache / forrest / forrest_08_release_site / . / docs_0_60 / upgrading_06.html
blob: e249507f5e4c138403695996c56e79c8cd5cd336 [file] [log] [blame]
<!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.8-dev">
<meta name="Forrest-skin-name" content="pelt">
<title>Upgrading to Apache Forrest 0.6 (v0.6)</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> &gt; <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');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
<input name="Search" value="Search" type="submit">
</form>
</div>
<!--+
|end search
+-->
<!--+
|start Tabs
+-->
<ul id="tabs">
<li>
<a class="unselected" href="../index.html">Welcome</a>
</li>
<li>
<a class="unselected" href="../contrib.html">Developers</a>
</li>
<li class="current">
<a class="selected" href="../versions/index.html">Versioned Docs</a>
</li>
<li>
<a class="unselected" href="../pluginDocs/index.html">Plugins</a>
</li>
<li>
<a class="unselected" href="../tools/index.html">Tools</a>
</li>
</ul>
<!--+
|end Tabs
+-->
</div>
</div>
<div id="main">
<div id="publishedStrip">
<!--+
|start Subtabs
+-->
<div id="level2tabs">
<a class="unselected" href="../docs_0_70/index.html">0.70 (current)</a><a class="unselected" href="../docs_0_80/index.html">0.80-dev (under development)</a><a class="selected" href="../docs_0_60/index.html">0.60 (past)</a>
</div>
<!--+
|end Endtabs
+-->
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<!--+
|breadtrail
+-->
<div class="breadtrail">
&nbsp;
</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');">0.60</div>
<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
<a href="../docs_0_60/index.html">Overview</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/faq.html">FAQs</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/changes.html">Changes</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/todo.html">Todo</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/your-project.html">Using Forrest</a>
</div>
<div class="menupage">
<div class="menupagetitle">Upgrading to 0.6</div>
</div>
<div class="menuitem">
<a href="../docs_0_60/validation.html">XML Validation</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/linking.html">Menus and Linking</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/searching.html">Searching</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/skins.html">Default Skins</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/skin-package.html">Skin Packages</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/forrest-contract.html">Our Contract</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/compliance.html">Standards Compliance</a>
</div>
<div onclick="SwitchMenu('menu_1.1.14', '../skin/')" id="menu_1.1.14Title" class="menutitle">How-To</div>
<div id="menu_1.1.14" class="menuitemgroup">
<div class="menuitem">
<a href="../docs_0_60/howto/index.html">Overview</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/howto-howto.html">Single Page</a>
</div>
<div onclick="SwitchMenu('menu_1.1.14.3', '../skin/')" id="menu_1.1.14.3Title" class="menutitle">Multi-Page</div>
<div id="menu_1.1.14.3" class="menuitemgroup">
<div class="menuitem">
<a href="../docs_0_60/howto/multi/howto-multi.html">Intro</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/multi/step1.html">Step 1</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/multi/step2.html">Step 2</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/multi/step3.html">Step 3</a>
</div>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/bugzilla-patch/howto-bugzilla-patch.html">With Images</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/howto-howto.html">Write a How-to</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/howto-asf-mirror.html">Download mirror</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/howto/howto-pdf-tab.html">Create tab PDF</a>
</div>
</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 href="../docs_0_60/build.html">Building Forrest</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/catalog.html">Using DTD Catalogs</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/sitemap-ref.html">Sitemap Reference</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/project-sitemap.html">Project sitemap</a>
</div>
<div class="menuitem">
<a href="../docs_0_60/cap.html">Sourcetype Action</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.16', '../skin/')" id="menu_1.1.16Title" class="menutitle">Reference docs</div>
<div id="menu_1.1.16" class="menuitemgroup">
<div onclick="SwitchMenu('menu_1.1.16.1', '../skin/')" id="menu_1.1.16.1Title" class="menutitle">DTD documentation</div>
<div id="menu_1.1.16.1" class="menuitemgroup">
<div class="menuitem">
<a href="../dtdx/dtd-docs.html">Overview</a>
</div>
<div class="menuitem">
<a href="../dtdx/document-v20.dtdx.html">document-v20</a>
</div>
<div class="menuitem">
<a href="../dtdx/howto-v20.dtdx.html">howto-v20</a>
</div>
<div class="menuitem">
<a href="../dtdx/faq-v20.dtdx.html">faq-v20</a>
</div>
<div class="menuitem">
<a href="../dtdx/document-v13.dtdx.html">document-v13</a>
</div>
<div class="menuitem">
<a href="../dtdx/howto-v13.dtdx.html">howto-v13</a>
</div>
<div class="menuitem">
<a href="../dtdx/faq-v13.dtdx.html">faq-v13</a>
</div>
</div>
<div onclick="SwitchMenu('menu_1.1.16.2', '../skin/')" id="menu_1.1.16.2Title" class="menutitle">Doc samples</div>
<div id="menu_1.1.16.2" class="menuitemgroup">
<div class="menuitem">
<a href="../dtdx/document-v13.html">document-v13</a>
</div>
<div class="menuitem">
<a href="../dtdx/document-v20.html">document-v20</a>
</div>
</div>
</div>
</div>
<div id="credit">
<hr>
This is documentation for past version v0.6
(<a href="http://forrest.apache.org/versions/">More</a>)</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 id="credit2">
<a href="http://apachecon.com/2007/EU/"><img border="0" title="ApacheCon Europe 2007" alt="ApacheCon Europe 2007 - logo" src="http://apache.org/ads/ApacheCon/2007-europe-125x125.png" style="width: 125px;height: 125px;"></a><a href="http://people.apache.org/calendar.html#200711"><img border="0" title="ApacheCon US 2007" alt="ApacheCon US 2007 - logo" src="http://apache.org/ads/ApacheCon/2007-usa-125x125.png" style="width: 125px;height: 125px;"></a>
</div>
</div>
<!--+
|end Menu
+-->
<!--+
|start content
+-->
<div id="content">
<div title="Portable Document Format" class="pdflink">
<a class="dida" href="upgrading_06.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
</div>
<div class="trail">Font size:
&nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
&nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
&nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>Upgrading to Apache Forrest 0.6</h1>
<div id="motd-area">
This is documentation for past version v0.6
(<a href="http://forrest.apache.org/versions/">More</a>)</div>
<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="#sync">General upgrade tips</a>
</li>
<li>
<a href="#home">New location of $FORREST_HOME</a>
</li>
<li>
<a href="#copyless">Copyless</a>
</li>
<li>
<a href="#sitemap">Project sitemaps take precedence.</a>
</li>
<li>
<a href="#skin-config-1">Private skins might need changes to document2html.xsl</a>
</li>
<li>
<a href="#skin-config-2">Various additions to skin configuration and new external DTD</a>
</li>
<li>
<a href="#antproxy">forrest.antproxy.xml is obsolete in favor of Ant's &lt;import&gt; task</a>
</li>
<li>
<a href="#ehtml">Deprecation of .ehtml and .ihtml</a>
</li>
<li>
<a href="#jspwiki">Deprecation of .cwiki filename extension to become .jspwiki</a>
</li>
<li>
<a href="#forrestbot">New forrestbot</a>
</li>
<li>
<a href="#dtd">New DTDs</a>
</li>
<li>
<a href="#catalog">SystemIdentifiers for DTDs changed to forrest.apache.org</a>
</li>
<li>
<a href="#local-catalog">Projects can use a local CatalogManager.properties</a>
</li>
<li>
<a href="#skin-names">Skins renamed and deleted</a>
</li>
<li>
<a href="#wholesite">Wholesite.html/pdf</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.6 version.
If you have other issues, then please discuss on either the
<a href="../mail-lists.html#forrest-dev">dev</a> or
<a href="../mail-lists.html#forrest-user">user</a>
mailing lists.
As more experience is gained, this document will be updated.
</p>
</div>
<a name="N1001F"></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.6
</p>
<ul>
<li>Copyless, so now used in place.</li>
<li>Project sitemaps take precedence.</li>
<li>Now using Subversion (SVN) for source control.</li>
<li>New skinconf capabilities and new external skinconf DTD.</li>
<li>New skins use CSS instead of tables. Old skins deprecated.</li>
<li>Forrestbot.</li>
</ul>
</div>
<a name="N1003E"></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="N1004B"></a><a name="sync"></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="N1005B"></a><a name="home"></a>
<h2 class="underlined_10">New location of $FORREST_HOME</h2>
<div class="section">
<p>
To use the new Forrest, run 'build.sh' or 'build.bat' as normal,
then change the FORREST_HOME environment variable to point to
forrest/src/core instead of the old forrest-0.5 location
(.../build/dist/shbat). Also make sure PATH gets updated to use the new
$FORREST_HOME/bin
</p>
</div>
<a name="N10065"></a><a name="copyless"></a>
<h2 class="underlined_10">Copyless</h2>
<div class="section">
<p>
In essence, Forrest does not create a dist anymore, and uses
itself in place. No more useless copying to a separate build space,
no more backcopying of your changes, all is used live.
</p>
<p>
It improves the build process a lot. Development turnaround time is
excellent. You can even tweak the main forrest core stylesheets and
see changes immediately.
</p>
</div>
<a name="N10072"></a><a name="sitemap"></a>
<h2 class="underlined_10">Project sitemaps take precedence.</h2>
<div class="section">
<p>With Forrest 0.6 it is now possible for projects to "plugin"
to our sitemaps, without needing to copy the main sitemaps and keep
them synchonised. This will enable hassle-free update to
future Forrest versions.</p>
<p>
If your old project did not use any customised <span class="codefrag">*.xmap</span>
files, then your upgrade process will be easy (you can safely skip this
section).</p>
<p>If your project did use custom <span class="codefrag">*.xmaps</span>, with matchers for
special circumstances (for example special doctypes that you
were handling) then you will need to be prepared to make some changes.
Hopefully with the new functionality of Forrest, you can do away with
your customisations altogether and just use the Forrest default
sitemaps. Try that first. If not, then read on...</p>
<p>Prior to 0.6 it was possible to replace *any* of the xmaps by placing
your own versions in your project directory, these were then copied over
to replace
the Forrest ones at build time. However, with the move to
<a href="#copyless">copyless</a> this no longer happens, instead
there is now an extension mechanism for the sitemap (as opposed to
a replacement mechanism).</p>
<p>When upgrading to Forrest 0.6 you need to copy customised matchers
in any of your projects <span class="codefrag">*.xmap</span> files into your projects
<span class="codefrag">sitemap.xmap</span> file. Any matchers in your project
<span class="codefrag">*.xmap</span> files that duplicate ones in Forrests own
<span class="codefrag">*.xmaps</span> can now be removed. This will ensure that future
enhancements to these matchers in Forrest will automatically be included
in your project.</p>
<p>Move your old sitemap out of the way, copy a default one from a fresh
'forrest seed', and add the specific matches that you require.</p>
<p>The good news is that this process makes upgrading to future versions
of Forrest much simpler, because your project <span class="codefrag">*.xmap</span> files will
contain only your customisations. As a result there will no longer be a
need to merge your custom xmaps with the updated ones in upcoming versions of
Forrest.</p>
<p>See <a href="../docs_0_60/project-sitemap.html">Using project
sitemaps</a> for more details.</p>
</div>
<a name="N100AE"></a><a name="skin-config-1"></a>
<h2 class="underlined_10">Private skins might need changes to document2html.xsl</h2>
<div class="section">
<p>
Moved all references to //skinconfig out of the document2html.xsl
into the site2xhtml.xsl file. If you have your own skins that were
referencing "$config" or "//skinconfig" in the document2html.xsl
then you need to make similar changes.
For further information, see Issue
<a href="http://issues.apache.org/jira/secure/ViewIssue.jspa?key=FOR-146">FOR-146</a>.
</p>
</div>
<a name="N100BC"></a><a name="skin-config-2"></a>
<h2 class="underlined_10">Various additions to skin configuration and new external DTD</h2>
<div class="section">
<p>
Various capabilities have been added to the skinconfig.
See the new descriptions in the
'<span class="codefrag">forrest seed</span>' site
<span class="codefrag">src/documentation/skinconf.xml</span> and synchronise yours.
</p>
<p>For example, to use different colors (e.g. the light blue of the old
krysalis skin), CSS colors can be specified in skinconf.xml
</p>
<p>
There is now an external DTD which makes it much easier to keep your
skinconf.xml synchronised.
</p>
</div>
<a name="N100D2"></a><a name="antproxy"></a>
<h2 class="underlined_10">forrest.antproxy.xml is obsolete in favor of Ant's &lt;import&gt; task</h2>
<div class="section">
<p>
Projects that use <span class="codefrag">forrest.antproxy.xml</span> via an Ant build
task to invoke Forrest, will receive
an error message directing them to this document.
Please see the <a href="../docs_0_60/your-project.html#invoking_from_ant">Invoking
Forrest from Ant</a> documentation for instructions on how to use
the &lt;import&gt; task to integrate Forrest with your build system.
</p>
</div>
<a name="N100E3"></a><a name="ehtml"></a>
<h2 class="underlined_10">Deprecation of .ehtml and .ihtml</h2>
<div class="section">
<p>
The .ehtml input file format has been deprecated and will likely be
removed in the next release.
Please convert all .ehtml files to .html files.
If you do '<span class="codefrag">forrest seed</span>' there is a sample html source file.
</p>
</div>
<a name="N100F0"></a><a name="jspwiki"></a>
<h2 class="underlined_10">Deprecation of .cwiki filename extension to become .jspwiki</h2>
<div class="section">
<p>
Use the .jspwiki filename extension rather than old .cwiki extension.
Clarifies that the purpose is the JSPWiki source format.
</p>
</div>
<a name="N100FA"></a><a name="forrestbot"></a>
<h2 class="underlined_10">New forrestbot</h2>
<div class="section">
<p>
The forrestbot and the forrestbot web interface have been completely
rewritten. There is no
direct way to convert old configurations to new configurations.
Please see the <a href="../tools/forrestbot.html">forrestbot
documentation</a> for instructions to create buildfiles that work
with the new forrestbot.
</p>
</div>
<a name="N10108"></a><a name="dtd"></a>
<h2 class="underlined_10">New DTDs</h2>
<div class="section">
<p>
Updated all v1.2 DTDs to become v1.3 DTDs (forward compatibility:
v1.2 docs will work fine as V1.3). The main change is the addition
of a @class attribute to every element, which enables the "extra-css"
section in the skinconf to be put to good use.
</p>
<p>
Updated the v2.0a DTDs to become v2.0 DTDs (forward incompatibility:
v1.2/1.3 docs are not forward-compatible as V2.0).
</p>
<pre class="code">
Changes from V1.2 to V1.3
=========================
document - Addition of class attribute all elements
faq - Addition of class attribute all elements
changes - Addition of class attribute all elements
howto - Addition of class attribute all elements
todo - Addition of class attribute all elements
Changes from V2.0a to V2.0
==========================
document - Addition of class attribute, all elements
- Addition of label attribute to note and
warning elements (consistent with v1.2/1.3)
faq - Class attribute, all elements
changes - New DTD
howto - New DTD
todo - New DTD
Changes from V1.3 to V2.0
=========================
document - Renamed &lt;link&gt; to &lt;a&gt;
- Removed &lt;fork&gt; and &lt;jump&gt;.
faq - Renamed &lt;part&gt; to &lt;faqsection&gt;
- @title attribute on &lt;faqs&gt; is now a nested
&lt;title&gt; element
- Same changes as in document between 1.3 and 2.0
changes - Same changes as in document between 1.3 and 2.0
howto - Same changes as in document between 1.3 and 2.0
todo - Same changes as in document between 1.3 and 2.0
</pre>
</div>
<a name="N10119"></a><a name="catalog"></a>
<h2 class="underlined_10">SystemIdentifiers for DTDs changed to forrest.apache.org</h2>
<div class="section">
<p>
Everyone should still continue to use the
<a href="../docs_0_60/catalog.html">Catalog Entity Resolver</a>
and that certainly still operates at the core of Forrest using the
well-defined PublicIdentifiers.
However, some impoverished XML tools do not, so they need to be able
to get the DTDs from the website. Some other tools rely on the System
Identifier rather than the Public Identifer. See Forrest Issue
<a href="http://issues.apache.org/jira/secure/ViewIssue.jspa?key=FOR-107">FOR-107</a>.
</p>
<p>
In previous versions of Forrest, and maybe in your application if
you copied the fresh-site xdocs, there were inconsistent
SystemIdentifiers. Some used local filenames, others used
apache.org/forrest/dtd/ URIs. In v0.6 we changed to use
System Identifiers at forrest.apache.org/dtd/ as resource URLs.
You do not need to change them because you are using the entity
resolver, but to remain consistent, it probably is best.
</p>
<p>
Beware if you have a catalog where the mapping is not declared properly.
The Catalog Entity Resolver will miss the local mapping and happily
go to the network to get the DTDs. That would cause Forrest to appear
to be slow for you, yet it will still operate properly. While we are
on that topic, if you use the XSLT document() function - there is a
<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=28341">Xalan bug 28341</a>
for DTD resolution via document() - please help to fix it.
Also see the
<a href="http://cocoon.apache.org/2.1/faq/faq-xslt.html">Cocoon FAQ</a>.
</p>
</div>
<a name="N10139"></a><a name="local-catalog"></a>
<h2 class="underlined_10">Projects can use a local CatalogManager.properties</h2>
<div class="section">
<p>
You can add a local CatalogManager.properties to your
project.classes-dir (usually src/documentation/classes/)
to define your additional catalogs for DTDs and other entities.
Copy a default file from a fresh 'forrest seed site'.
</p>
<p>
If you do not add such a configuration file, then there will be a
harmless message on startup "CatalogManager.properties not found".
</p>
</div>
<a name="N10146"></a><a name="skin-names"></a>
<h2 class="underlined_10">Skins renamed and deleted</h2>
<div class="section">
<p>Skins now have a naming convention. The default skins are
<a href="skins.html">described</a>.</p>
<p>The old skin names are automatically mapped to the new names. You
should change your forrest.properties to use the new names.</p>
<p>The following skins were renamed (the old names still work, but may not in future releases).</p>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<tr>
<th colspan="1" rowspan="1">0.5 Name</th><th colspan="1" rowspan="1">0.6 Name</th>
</tr>
<tr>
<td colspan="1" rowspan="1">krysalis-site</td><td colspan="1" rowspan="1">crust</td>
</tr>
<tr>
<td colspan="1" rowspan="1">tigris-style</td><td colspan="1" rowspan="1">tigris</td>
</tr>
</table>
<p>The following skins were deleted (the old names still work, but may not in future releases).</p>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<tr>
<th colspan="1" rowspan="1">0.5 Name</th><th colspan="1" rowspan="1">0.6 Alias</th>
</tr>
<tr>
<td colspan="1" rowspan="1">forrest-css</td><td colspan="1" rowspan="1">crust</td>
</tr>
<tr>
<td colspan="1" rowspan="1">avalon-tigris</td><td colspan="1" rowspan="1">tigris</td>
</tr>
</table>
<p>The old "forrest-site" skin is retained for a little while longer,
but is deprecated, so please move to one of the other skins.</p>
</div>
<a name="N101A2"></a><a name="wholesite"></a>
<h2 class="underlined_10">Wholesite.html/pdf</h2>
<div class="section">
<p>Instead of using names "site.html/pdf" to create an aggregate page
of your entire site, use "wholesite.html/pdf". The old names are still
supported for backwards compatibility but they may not be in the
future.</p>
</div>
<a name="N101AC"></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="../mail-lists.html#forrest-dev">mailing list</a>.</p>
</div>
</div>
<!--+
|end content
+-->
<div class="clearboth">&nbsp;</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 &copy;
2002-2007 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
+-->
</div>
</body>
</html>