Return-Path: 
 <svn-return-5331-apmail-forrest-svn-archive=forrest.apache.org@forrest.apache.org>
Delivered-To: apmail-forrest-svn-archive@www.apache.org
Received: (qmail 7511 invoked from network); 14 Apr 2006 13:07:50 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 14 Apr 2006 13:07:50 -0000
Received: (qmail 65070 invoked by uid 500); 14 Apr 2006 13:07:27 -0000
Delivered-To: apmail-forrest-svn-archive@forrest.apache.org
Received: (qmail 65032 invoked by uid 500); 14 Apr 2006 13:07:27 -0000
Mailing-List: contact svn-help@forrest.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:svn-help@forrest.apache.org>
list-unsubscribe: <mailto:svn-unsubscribe@forrest.apache.org>
List-Post: <mailto:svn@forrest.apache.org>
Reply-To: "Forrest Developers List" <dev@forrest.apache.org>
List-Id: <svn.forrest.apache.org>
Delivered-To: mailing list svn@forrest.apache.org
Received: (qmail 65021 invoked by uid 99); 14 Apr 2006 13:07:27 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 14 Apr 2006 06:07:27 -0700
X-ASF-Spam-Status: No, hits=-9.4 required=10.0
	tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194)
    by apache.org (qpsmtpd/0.29) with SMTP; Fri, 14 Apr 2006 06:07:26 -0700
Received: (qmail 7328 invoked by uid 65534); 14 Apr 2006 13:07:06 -0000
Message-ID: <20060414130706.7323.qmail@minotaur.apache.org>
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r394082 -
 /forrest/trunk/site-author/content/xdocs/pluginDocs/plugins_0_80/usingPlugins.xml
Date: Fri, 14 Apr 2006 13:07:05 -0000
To: svn@forrest.apache.org
From: cdupoirieux@apache.org
X-Mailer: svnmailer-1.0.7
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Author: cdupoirieux
Date: Fri Apr 14 06:07:03 2006
New Revision: 394082

URL: http://svn.apache.org/viewcvs?rev=394082&view=rev
Log:
Fall back mecanism of Plugin installation (FOR-388, FOR-742)

Modified:
    forrest/trunk/site-author/content/xdocs/pluginDocs/plugins_0_80/usingPlugins.xml

Modified: forrest/trunk/site-author/content/xdocs/pluginDocs/plugins_0_80/usingPlugins.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/pluginDocs/plugins_0_80/usingPlugins.xml?rev=394082&r1=394081&r2=394082&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/pluginDocs/plugins_0_80/usingPlugins.xml (original)
+++ forrest/trunk/site-author/content/xdocs/pluginDocs/plugins_0_80/usingPlugins.xml Fri Apr 14 06:07:03 2006
@@ -68,7 +68,7 @@
           a plugin you should add "-VERSION_NUMBER" to the end of the plugin name. For example,
           to force forrest to use the 1.0 version of the OpenOffice.org plugin you would use
           <code>org.apache.forrest.plugin.input.OpenOffice.org-1.0</code>. If you define a version of the
-          plugin that does not exist then it will fall back to using the most recent version avialable.
+          plugin that does not exist then it will fall back to using the most recent version available.
           This feature is useful when 
           developing a new site as you can quickly force a plugin upgrade by deleting all installed 
           plugins (use the command 'ant cleanPlugins'). However, this might result in the installation
@@ -77,6 +77,21 @@
         </section>
         <section id="sources">
           <title>Where does Forrest look for Plugins sources ?</title>
+          <p>Forrest uses a fall back mecanism to find the plugins to install for a project.</p>
+          <p>For an unversionned plugin, Forrest tries to get it from :</p>
+          <ol>
+            <li>different local sources directories (<code>project.required.plugins.src</code> property)</li>
+            <li>if not found : the remote site in the forrest version directory</li>
+            <li>if not found : the remote site (with no forrest version directory)</li>
+          </ol>
+          <p>For a versionned plugin, Forrest tries to get :</p>
+          <ol>
+            <li>the versionned plugin from different local sources directories (<code>project.required.plugins.src</code> property)</li>
+            <li>if not found : the versionned plugin from the remote site in the forrest version directory</li>
+            <li>if not found : the unversionned plugin in different local sources directory (<code>project.required.plugins.src</code> property again)</li>
+            <li>if not found : the unversionned plugin from the remote site in the forrest version directory</li>
+            <li>if not found : the remote site (with no forrest version directory)</li>
+          </ol>
           <p>By default, forrest looks into the two following directories to find plugins sources : <code>${forrest.home}/plugins</code> and <code>${forrest.home}/whiteboard/plugins</code>.
           It is possible to add other sources locations by specifying the <code>project.required.plugins.src</code> property 
           in the projects <code>forrest.properties</code> file.</p>
@@ -84,7 +99,7 @@
           <source>project.required.plugins.src=${forrest.home}/plugins,${forrest.home}/whiteboard/plugins,${project.home}/plugins</source>
            <p>
            will add the project specific directory <code>${project.home}/plugins</code> to the list of directories to search in.</p>
-          <p>if sources are not found, forrest will try to get them from the Web. Forrest <em>knows</em> the plugins description with plugins descriptors files 
+          <p>If sources are not found, forrest will try to get them from the Web. Forrest <em>knows</em> the plugins description with plugins descriptors files 
           in which plugins are described as follows :</p>
           <source><![CDATA[<plugin name="org.apache.forrest.plugin.output.pdf"
   type="output"