# HG changeset patch
# User Mark Doliner <mark@kingant.net>
# Date 1131067798 0
# Node ID d8787960e398130a8f8aa7c6a179c23769af1f9b
# Parent  b634605fa7ca245d30eee02e7287566fdc411e49
[gaim-migrate @ 14254]
Documentation

committer: Tailor Script <tailor@pidgin.im>

diff -r b634605fa7ca -r d8787960e398 src/plugin.c
--- a/src/plugin.c	Thu Nov 03 21:11:51 2005 +0000
+++ b/src/plugin.c	Fri Nov 04 01:29:58 2005 +0000
@@ -57,6 +57,11 @@
 static GList *plugin_loaders   = NULL;
 #endif
 
+/*
+ * TODO: I think the intention was to allow multiple load and unload
+ *       callback functions.  Perhaps using a GList instead of a
+ *       pointer to a single function.
+ */
 static void (*probe_cb)(void *) = NULL;
 static void *probe_cb_data = NULL;
 static void (*load_cb)(GaimPlugin *, void *) = NULL;
diff -r b634605fa7ca -r d8787960e398 src/plugin.h
--- a/src/plugin.h	Thu Nov 03 21:11:51 2005 +0000
+++ b/src/plugin.h	Fri Nov 04 01:29:58 2005 +0000
@@ -97,10 +97,9 @@
 	char *author;
 	char *homepage;
 
-	/*
-	 * TODO: I think the intention was the allow multiple load and unload
-	 * callback functions.  Perhaps using a GList instead of a pointer to
-	 * 1 function.
+	/**
+	 * If a plugin defines a 'load' function, and it returns FALSE,
+	 * then the plugin will not be loaded.
 	 */
 	gboolean (*load)(GaimPlugin *plugin);
 	gboolean (*unload)(GaimPlugin *plugin);