Changes between Version 44 and Version 45 of TracPlugins

Timestamp:

Dec 10, 2007, 8:27:46 PM (16 years ago)

Author:

osimons

Comment:

Plugin loading term clarification - using 'Trac server' instead of 'Trac instance'.

TracPlugins

@@ -154 +154 @@
 
 If you put your plugins inside plugins directories, and certainly if you have more than one project, you need to make sure that the correct version of the plugin is loading. Here are som basic rules:
- * Only one version of the plugin can be loaded for any running Trac instance. The Python namespaces and module list will be shared, and it cannot handle duplicates. If a plugin is `enabled` or `disabled` makes no difference.
+ * Only one version of the plugin can be loaded for each running Trac server (ie. each Python process). The Python namespaces and module list will be shared, and it cannot handle duplicates. Whether a plugin is `enabled` or `disabled` makes no difference.
  * A globally installed plugin (typically `setup.py install`) will override any version in global or project plugins directories. A plugin from the global plugins directory will be located before any project plugins directory.
- * If your Trac instance serves more than one project, then having two versions of a plugin in two different projects will give uncertain results. Only one of them will load, and the one loaded will be shared by both projects. Trac will load the first found - basically from the project that receives the first request.
+ * If your Trac server hosts more than one project (as with `TRAC_ENV_PARENT_DIR` setups), then having two versions of a plugin in two different projects will give uncertain results. Only one of them will load, and the one loaded will be shared by both projects. Trac will load the first found - basically from the project that receives the first request.
  * Having more than one version listed inside Python site-packages is fine (ie. installed with `setup.py install`) - setuptools will make sure you get the version installed most recently. However, don't store more than one version inside a global or project plugins directory - neither version number nor installed date will matter at all. There is no way to determine which one will be located first when Trac searches the directory for plugins.