Author: crossley
Date: Fri Jan 14 01:18:42 2011
New Revision: 1058828
URL: http://svn.apache.org/viewvc?rev=1058828&view=rev
Log:
Add a "upgrade" note about the new PDF plugin.
Issue: FOR-1077
Modified:
forrest/trunk/site-author/content/xdocs/docs_0_90/upgrading_09.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=1058828&r1=1058827&r2=1058828&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 Fri Jan
14 01:18:42 2011
@@ -163,6 +163,35 @@
(added in v0.9 - <a href="site:faq/sitemap-entities">FAQ</a>).
</p>
</section>
+ <section id="pdf">
+ <title>Improved PDF output plugin</title>
+ <p>
+ Many plugins have been upgraded and there are some new plugins.
+ See the <a href="site:changes">Changes</a> and the <a
href="site:pluginVersions/overview">Plugins</a>
+ documentation.
+ </p>
+ <p>
+ In particular, the PDF output plugin has many improvements, uses a
newer Apache FOP etc.
+ It is much more configurable, See its plugin documentation.
+ </p>
+ <p>
+ However there is a minor, but annoying, problem.
+ See <a
href="https://issues.apache.org/jira/browse/FOR-1077";>FOR-1077</a>.
+ Forrest (via Cocoon) re-generates every document. Every PDF now gets
differences
+ due to some internal metadata dates, even though its content might not
have changed.
+ When the documentation set is deployed, e.g. via svn, these changed
files will also
+ be deployed.
+ </p>
+ <p>
+ For the Forrest project website, we decided to stop (via skinconf.xml)
using PDFs
+ for every page and do it only for some specific documents.
+ </p>
+ <p>
+ Remember that if you need to use an old version of any plugin, then it
can be
+ specified in forrest.properties by appending the version number (e.g.
"-0.2" or "-0.3")
+ to the required plugin name.
+ </p>
+ </section>
<section id="docs">
<title>Notes about documentation</title>
<p>
@@ -172,8 +201,8 @@
there are example snippets of sitemaps which have not yet been upgraded
to reflect the changes to the sitemaps and the separation of some core
stuff into plugins. See issues
- <a href="http://issues.apache.org/jira/browse/FOR-546";>FOR-546</a> and
- <a href="http://issues.apache.org/jira/browse/FOR-922";>FOR-922</a> and
+ <a href="https://issues.apache.org/jira/browse/FOR-546";>FOR-546</a> and
+ <a href="https://issues.apache.org/jira/browse/FOR-922";>FOR-922</a> and
others.
</p>
</section>
