2006-04-29 [colin] 2.1.1cvs42
[claws.git] / manual / plugins.xml
index b5e3cba3fc828651345d2b0777a1d248e6228294..1d6ecad9b9a683136208c7d6818bc7260e4a1100 100644 (file)
@@ -25,7 +25,7 @@
            <listitem>
                        <para>The SpamAssassin plugin comes with two major features:</para>
                        <para>The ability to scan incoming mail received from a POP, IMAP or LOCAL account using SpamAssassin. It can optionally delete mail identified as spam or save it to a designated folder. Mail scanning can be turned off, which is useful if your email is scanned on your server.</para>
-                       <para>The ability for users to teach SpamAssassin to recognise spam or ham. You can train SpamAssassin by marking messages as spam or ham from the message list contextual menu, or using the relevant toolbar button in the main window or the message window (see "Configuration/Preferences/Customize toolbars"). Messages marked as spam are optionally saved to a designated folder.</para>
+                       <para>The ability for users to teach SpamAssassin to recognise spam or ham. You can train SpamAssassin by marking messages as spam or ham from the Message List contextual menu, or using the relevant toolbar button in the main window or the message window (see "Configuration/Preferences/Customize toolbars"). Messages marked as spam are optionally saved to a designated folder.</para>
                        <para>Plugin preferences can be found in "Configuration/Preferences/Plugins/SpamAssassin".</para>
                        <para>SpamAssassin is available from <ulink url="http://spamassassin.apache.org/">http://spamassassin.apache.org/</ulink>. Version 3.1.x or higher is required to use the learning feature in TCP mode.</para>
                </listitem>
        If you're a developer, writing a plugin to extend Sylpheed-Claws' capabilities is probably the best and easiest solution. We will provide hosting to your code, and will be glad to answer your questions in the mailing-list or the IRC channel, #sylpheed on IRCnet.
     </para>
   </section>
-
+  <section id="plugins_network">
+    <title>Network access from the plugins</title>
+    <para>
+       Some of the external plugins, for example RSSyl, vCalendar or GtkHtml Viewer, need Internet access for their operations (retrieving feeds in the case of RSSyl or vCalendar, and fetching images in the case of GtkHtml Viewer). These plugins use the Curl library. Hence, if your Internet access is restricted by a proxy, you will need to tell libCurl to use this proxy. This is done by setting an environment variable, <emphasis>http_proxy</emphasis>. For example, <emphasis>http_proxy=http://user:passwd@myproxy.example.com:8080</emphasis> will tell libCurl to connect to port 8080 of the machine myproxy.example.com, with the user <quote>user</quote> and password <quote>passwd</quote> to connect to the Internet. 
+    </para>
+    <para>
+       You can either set this variable before starting Sylpheed-Claws, by using for example <emphasis>http_proxy=http://user:passwd@myproxy.example.com:8080 sylpheed-claws</emphasis>, or set it in your ~/.bashrc file, by adding the following line: <emphasis>export http_proxy=http://user:passwd@myproxy.example.com:8080</emphasis> (you'll have to reconnect to have it taken into account).
+    </para>
+  </section>
 </section>