From: Ricardo Mones <ricardo@mones.org>
Date: Tue, 5 Jul 2016 13:01:46 +0000 (+0200)
Subject: Fix #3653: document plugin path configuration
X-Git-Tag: 3.14.0~57
X-Git-Url: http://git.claws-mail.org/?p=claws.git;a=commitdiff_plain;h=dc8db42475570161448318cf1677048fd7b90ea0

Fix #3653: document plugin path configuration
---

diff --git a/manual/plugins.xml b/manual/plugins.xml
index 421e6df91..6cb2629ae 100644
--- a/manual/plugins.xml
+++ b/manual/plugins.xml
@@ -389,5 +389,31 @@
     </para>
   </section>
 
+  <section id="plugin_path_config">
+    <title>Plugin path configuration</title>
+    <para>
+    By default, when loading a plugin, its full path is saved in
+    <filename>~/.claws-mail/clawsrc</filename>.
+    </para><para>
+    As most users have only one copy of Claws Mail installed and always
+    use the same installation method, this is not a problem.
+    </para><para>
+    However, if you have multiple copies of Claws Mail installed
+    and want to share the same configuration among them, this may not
+    work, particularly when using different versions of Claws Mail.
+    </para><para>
+    A second installed copy will try to load the plugins installed by
+    the first and, if the versions differ, the plugins will be rejected.
+    </para><para>
+    In order to avoid this problem you can manually edit the plugins
+    section in the <filename>clawsrc</filename> file, replacing the full
+    path with just the plugin file name of those you want to load
+    relative to the copy of Claws Mail being run.
+    </para><para>
+    In so doing, each copy of Claws Mail will try to load those plugins
+    from its own plugin directory, rather than a fixed location.
+    </para>
+  </section>
+
 </section>