Author: crossley
Date: Thu Mar 2 23:32:41 2006
New Revision: 382706
URL: http://svn.apache.org/viewcvs?rev=382706&view=rev
Log:
* Add FAQ #faq "How to use these FAQs?"
* Add FAQ #older-plugins "How to use older versions of specific plugins?"
Modified:
forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml
forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
Modified: forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml
URL:
http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml?rev=382706&r1=382705&r2=382706&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_70/faq.xml Thu Mar 2
23:32:41 2006
@@ -21,6 +21,15 @@
<faqs title="Frequently Asked Questions">
<part id="getting_started">
<title>Getting Started and Building Forrest</title>
+ <faq id="faq">
+ <question> How to use these FAQs? </question>
+ <answer>
+ <p>
+ There is no particular order to these FAQs. Use your browser's
+ "Find in this page" facility to search for keywords.
+ </p>
+ </answer>
+ </faq>
<faq id="overview">
<question> Where can I read an overview about how to work with Forrest?
</question>
<answer>
@@ -54,6 +63,34 @@
<p> Follow these <link href="site:v0.70//build">Building
Forrest</link> notes. </p>
<p> The <link href="site:v0.70//your-project">Using Forrest</link>
guide provides further
step-by-step assistance in getting started with Forrest for your
project. </p>
+ </answer>
+ </faq>
+ <faq id="older-plugins">
+ <question> How to use older versions of specific plugins? </question>
+ <answer>
+ <p>
+ Sometimes one does not want to use the most recent functionality
+ of a plugin and instead need to use an older version.
+ Information about changes to each plugin can be found in its
+ <link href="site:v0.70//plugins/index">documentation</link>.
+ </p>
+ <p>
+ In the forrest.properties file, specify the version of the plugin
+ that you require, e.g.
+ </p>
+
<source>project.required.plugins=org.apache.forrest.plugin.input.PhotoGallery-0.1,...</source>
+ <p>
+ Users of Forrest-0.7 will need to do this for the projectInfo plugin
+ if you get the following error ...
+ </p>
+ <source>Could not find component for role:
+ [org.apache.cocoon.components.modules.input.InputModule/lm]
+ (Key='org.apache.cocoon.components.modules.input.InputModule/</source>
+ <p>
+ ... then sorry, we mistakenly added new "locationmap" functionality
+ (due in version 0.8). So do this ...
+ </p>
+
<source>project.required.plugins=org.apache.forrest.plugin.input.projectInfo-0.1,...</source>
</answer>
</faq>
<faq id="single-document">
Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
URL:
http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml?rev=382706&r1=382705&r2=382706&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml Thu Mar 2
23:32:41 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
- Copyright 2002-2005 The Apache Software Foundation or its licensors,
+ Copyright 2002-2006 The Apache Software Foundation or its licensors,
as applicable.
Licensed under the Apache License, Version 2.0 (the "License");
@@ -21,6 +21,15 @@
<faqs title="Frequently Asked Questions">
<part id="getting_started">
<title>Getting Started and Building Forrest</title>
+ <faq id="faq">
+ <question> How to use these FAQs? </question>
+ <answer>
+ <p>
+ There is no particular order to these FAQs. Use your browser's
+ "Find in this page" facility to search for keywords.
+ </p>
+ </answer>
+ </faq>
<faq id="overview">
<question> Where can I read an overview about how to work with Forrest?
</question>
<answer>
@@ -56,6 +65,34 @@
step-by-step assistance in getting started with Forrest for your
project. </p>
</answer>
</faq>
+ <faq id="older-plugins">
+ <question> How to use older versions of specific plugins? </question>
+ <answer>
+ <p>
+ Sometimes one does not want to use the most recent functionality
+ of a plugin and instead need to use an older version.
+ Information about changes to each plugin can be found in its
+ <link href="site:v0.80//plugins/index">documentation</link>.
+ </p>
+ <p>
+ In the forrest.properties file, specify the version of the plugin
+ that you require, e.g.
+ </p>
+
<source>project.required.plugins=org.apache.forrest.plugin.input.PhotoGallery-0.1,...</source>
+ <p>
+ Users of Forrest-0.7 will need to do this for the projectInfo plugin
+ if you get the following error ...
+ </p>
+ <source>Could not find component for role:
+ [org.apache.cocoon.components.modules.input.InputModule/lm]
+ (Key='org.apache.cocoon.components.modules.input.InputModule/</source>
+ <p>
+ ... then sorry, we mistakenly added new "locationmap" functionality
+ (due in version 0.8). So do this ...
+ </p>
+
<source>project.required.plugins=org.apache.forrest.plugin.input.projectInfo-0.1,...</source>
+ </answer>
+ </faq>
<faq id="single-document">
<question> What is the best way to generate "standalone documents" using
Forrest? </question>
<answer>
@@ -121,7 +158,7 @@
</answer>
</faq>
<faq id="debug">
- <question> How can I start forrest in debug mode? </question>
+ <question> How can I start forrest in Java debug mode? </question>
<answer>
<p> The <code>forrest.jvmargs</code> property in the
<code>forrest.properties</code> file
can be used to start forrest in debug mode on a specific port.
