RSSyl: Allow use of .netrc by libcurl. Bug/enhancement #3309, by Vincent Pelletier

[claws.git] / src / plugins / python / python_plugin.c

diff --git a/src/plugins/python/python_plugin.c b/src/plugins/python/python_plugin.c
index 4cdba316faeafb48e98453dbb778736a506012a9..69d7e58064b5469d66c4efa3c592ad8e60c8314c 100644 (file)
--- a/src/plugins/python/python_plugin.c
+++ b/src/plugins/python/python_plugin.c
@@ -20,11 +20,11 @@
 #include "claws-features.h"
 #endif
 
+#include <Python.h>
+
 #include <glib.h>
 #include <glib/gi18n.h>
 
-#include <Python.h>
-
 #include <errno.h>
 
 #include "common/hooks.h"
@@ -728,14 +728,36 @@ const gchar *plugin_name(void)
 const gchar *plugin_desc(void)
 {
   return _("This plugin provides Python integration features.\n"
-           "\nFor the most up-to-date API documentation, type\n"
-           "\n help(clawsmail)\n"
-           "\nin the interactive Python console under Tools -> Show Python console.\n"
-           "\nThe source distribution of this plugin comes with various example scripts "
-           "in the \"examples\" subdirectory. If you wrote a script that you would be "
-           "interested in sharing, feel free to send it to me to have it considered "
-           "for inclusion in the examples.\n"
-           "\nFeedback to <berndth@gmx.de> is welcome.");
+      "Python code can be entered interactively into an embedded Python console, "
+      "under Tools -> Show Python console, or stored in scripts.\n\n"
+      "These scripts are then available via the menu. You can assign "
+      "keyboard shortcuts to them just like it is done with other menu items. "
+      "You can also put buttons for script invocation into the toolbars "
+      "using Claws Mail's builtin toolbar editor.\n\n"
+      "You can provide scripts working on the main window by placing files "
+      "into ~/.claws-mail/python-scripts/main.\n\n"
+      "You can also provide scripts working on an open compose window "
+      "by placing files into ~/.claws-mail/python-scripts/compose.\n\n"
+      "The folder ~/.claws-mail/python-scripts/auto/ may contain some "
+      "scripts that are automatically executed when certain events "
+      "occur. Currently, the following files in this directory "
+      "are recognised:\n\n"
+      "compose_any\n"
+      "Gets executed whenever a compose window is opened, no matter "
+      "if that opening happened as a result of composing a new message, "
+      "replying or forwarding a message.\n\n"
+      "startup\n"
+      "Executed at plugin load\n\n"
+      "shutdown\n"
+      "Executed at plugin unload\n\n"
+      "\nFor the most up-to-date API documentation, type\n"
+      "\n help(clawsmail)\n"
+      "\nin the interactive Python console.\n"
+      "\nThe source distribution of this plugin comes with various example scripts "
+      "in the \"examples\" subdirectory. If you wrote a script that you would be "
+      "interested in sharing, feel free to send it to me to have it considered "
+      "for inclusion in the examples.\n"
+      "\nFeedback to <berndth@gmx.de> is welcome.");
 }
 
 const gchar *plugin_type(void)