forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r189861 - in /forrest/trunk/site-author/content/xdocs/docs/plugins: pluginInfrastructure.xml usingPlugins.xml
Date Fri, 10 Jun 2005 00:03:38 GMT
Author: rgardler
Date: Thu Jun  9 17:03:37 2005
New Revision: 189861

Add basic docs for the new verioned plugin system


Modified: forrest/trunk/site-author/content/xdocs/docs/plugins/pluginInfrastructure.xml
--- forrest/trunk/site-author/content/xdocs/docs/plugins/pluginInfrastructure.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs/plugins/pluginInfrastructure.xml Thu Jun
 9 17:03:37 2005
@@ -28,12 +28,6 @@
       <p>Forrest can be extended with the addition of plugins. This document
       describes what a plugin is and outlines the plugin infrastructure so
       that you can start building your own Forrest extensions.</p>
-      <warning>The Plugin Infrastructure is still at an early stage of design 
-      and implementation, consequently this document <em>may</em> be out of date.
-      If you are having problems with any of the details, please search for help
-      on the developer mailing list. If you can't find your answer ask
-      for help on that list.</warning>
@@ -124,7 +118,8 @@
         <title>Naming Conventions</title>
-        <p>Technically you can name a plugin anything you like. However, we
+        <p>Technically you can name a plugin anything you like with one
+        small restriction (see below). However, we
         do have some naming conventions that we recomend you follow. This is
         to minimise the chances of collision between plugins from different
@@ -138,6 +133,11 @@
         <p>Where <code>PLUGIN_TYPE</code> is either "internal", "input"
         "output" and <code>PLUGIN_NAME"</code> is a suitable name chosen by
+        <warning>Plugin names cannot have a '-' character in them. This character
+        is used to indicate the start of a version number when defining a plugin
+        to be used. See <a href="site:documentation/plugins/using">Using Plugins</a>
for more 
+        information.</warning>

Modified: forrest/trunk/site-author/content/xdocs/docs/plugins/usingPlugins.xml
--- forrest/trunk/site-author/content/xdocs/docs/plugins/usingPlugins.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs/plugins/usingPlugins.xml Thu Jun  9 17:03:37
@@ -53,6 +53,20 @@
       will cause Forrest to load the plugins called ""
+      <p>In the absence of a version number for the plugin (as is the case in the examples
+      the most recent version that is applicabe to your release of Forrest will be used.
+      may result in unexpected behaviour if a new version of the plugin has been released
+      is incompatible with your current site. To force Forrest into using a specific version
+      a plugin you shuld add "-VERSION_NUMBER" to the end of the plugin name. For example,
+      to force forrest to use the 1.0 version of the plugin you would use
+      <code></code> If you define
a version of the
+      plugin that does not exist then it will fall back to using the most recent version
+      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
+      of an in-development plugin, therefore in a production environment you should always
+      a known working version.</p>
       <p>By default a new forrest project includes plugins to generate 
       PDF output from your source documents.</p>

View raw message