gtranslator r3733 - in trunk/src: . plugin-system

[icq svn gnome org]

Author: icq
Date: Mon Sep 22 09:45:36 2008
New Revision: 3733
URL: http://svn.gnome.org/viewvc/gtranslator?rev=3733&view=rev

Log:
Squashed commit of the following:

commit 0b07d1adad5ec2b3c362e6f3242f6fb43dc057e1
Author: Ignacio Casal Quinteiro <nacho resa gmail com>
Date:   Mon Aug 25 12:34:27 2008 +0200

    2008-08-25  Ignacio Casal Quinteiro  <nacho resa gmail com>

    	* plugin-system/plugin-manager.c (about_button_cb):
    	* plugin-system/plugin.c:
    	* plugin-system/plugin.h:
    	* plugin-system/update-from-gedit.sh:
    	Sinchronized to get the doc I added to gedit. And fixed a bug in
    the
    	update script.

Modified:
   trunk/src/ChangeLog
   trunk/src/plugin-system/plugin-manager.c
   trunk/src/plugin-system/plugin.c
   trunk/src/plugin-system/plugin.h
   trunk/src/plugin-system/update-from-gedit.sh

Modified: trunk/src/plugin-system/plugin-manager.c
==============================================================================
--- trunk/src/plugin-system/plugin-manager.c	(original)
+++ trunk/src/plugin-system/plugin-manager.c	Mon Sep 22 09:45:36 2008
@@ -26,7 +26,7 @@
  * list of people on the gtranslator Team.  
  * See the ChangeLog files for a list of changes. 
  *
- * $Id: plugin-manager.c 6371 2008-08-09 13:43:02Z jessevdk $
+ * $Id: plugin-manager.c 6406 2008-08-13 20:04:04Z pborelli $
  */
 
 #ifdef HAVE_CONFIG_H
@@ -103,7 +103,7 @@
 		gtk_widget_destroy (pm->priv->about);
 
 	pm->priv->about = g_object_new (GTK_TYPE_ABOUT_DIALOG,
-		"name", gtranslator_plugin_info_get_name (info),
+		"program-name", gtranslator_plugin_info_get_name (info),
 		"copyright", gtranslator_plugin_info_get_copyright (info),
 		"authors", gtranslator_plugin_info_get_authors (info),
 		"comments", gtranslator_plugin_info_get_description (info),

Modified: trunk/src/plugin-system/plugin.c
==============================================================================
--- trunk/src/plugin-system/plugin.c	(original)
+++ trunk/src/plugin-system/plugin.c	Mon Sep 22 09:45:36 2008
@@ -25,7 +25,7 @@
  * list of people on the gtranslator Team.  
  * See the ChangeLog files for a list of changes. 
  *
- * $Id: plugin.c 4509 2006-01-06 16:45:20Z pborelli $
+ * $Id: plugin.c 6448 2008-08-25 10:28:33Z icq $
  */
 
 #ifdef HAVE_CONFIG_H
@@ -72,6 +72,13 @@
 	/* Empty */
 }
 
+/**
+ * gtranslator_plugin_activate:
+ * @plugin: a #GtranslatorPlugin
+ * @window: a #GtranslatorWindow
+ * 
+ * Activates the plugin.
+ */
 void
 gtranslator_plugin_activate (GtranslatorPlugin *plugin,
 		       GtranslatorWindow *window)
@@ -82,6 +89,13 @@
 	GTR_PLUGIN_GET_CLASS (plugin)->activate (plugin, window);
 }
 
+/**
+ * gtranslator_plugin_deactivate:
+ * @plugin: a #GtranslatorPlugin
+ * @window: a #GtranslatorWindow
+ * 
+ * Deactivates the plugin.
+ */
 void
 gtranslator_plugin_deactivate	(GtranslatorPlugin *plugin,
 			 GtranslatorWindow *window)
@@ -91,7 +105,15 @@
 
 	GTR_PLUGIN_GET_CLASS (plugin)->deactivate (plugin, window);
 }
-				 
+
+/**
+ * gtranslator_plugin_update_ui:
+ * @plugin: a #GtranslatorPlugin
+ * @window: a #GtranslatorWindow
+ *
+ * Triggers an update of the user interface to take into account state changes
+ * caused by the plugin.
+ */		 
 void
 gtranslator_plugin_update_ui	(GtranslatorPlugin *plugin,
 			 GtranslatorWindow *window)
@@ -102,6 +124,14 @@
 	GTR_PLUGIN_GET_CLASS (plugin)->update_ui (plugin, window);
 }
 
+/**
+ * gtranslator_plugin_is_configurable:
+ * @plugin: a #GtranslatorPlugin
+ *
+ * Whether the plugin is configurable.
+ *
+ * Returns: TRUE if the plugin is configurable:
+ */
 gboolean
 gtranslator_plugin_is_configurable (GtranslatorPlugin *plugin)
 {
@@ -110,6 +140,14 @@
 	return GTR_PLUGIN_GET_CLASS (plugin)->is_configurable (plugin);
 }
 
+/**
+ * gtranslator_plugin_create_configure_dialog:
+ * @plugin: a #GtranslatorPlugin
+ *
+ * Creates the configure dialog widget for the plugin.
+ *
+ * Returns: the configure dialog widget for the plugin.
+ */
 GtkWidget *
 gtranslator_plugin_create_configure_dialog (GtranslatorPlugin *plugin)
 {

Modified: trunk/src/plugin-system/plugin.h
==============================================================================
--- trunk/src/plugin-system/plugin.h	(original)
+++ trunk/src/plugin-system/plugin.h	Mon Sep 22 09:45:36 2008
@@ -25,7 +25,7 @@
  * list of people on the gtranslator Team.  
  * See the ChangeLog files for a list of changes. 
  *
- * $Id: plugin.h 5666 2007-06-29 19:52:25Z sfre $
+ * $Id: plugin.h 6448 2008-08-25 10:28:33Z icq $
  */
 
 #ifndef __GTR_PLUGIN_H__
@@ -112,10 +112,10 @@
 GtkWidget	*gtranslator_plugin_create_configure_dialog		
 						(GtranslatorPlugin *plugin);
 
-/*
- * Utility macro used to register plugins
+/**
+ * GTR_PLUGIN_REGISTER_TYPE_WITH_CODE(PluginName, plugin_name, CODE):
  *
- * use: GTR_PLUGIN_REGISTER_TYPE_WITH_CODE(PluginName, plugin_name, CODE)
+ * Utility macro used to register plugins with additional code.
  */
 #define GTR_PLUGIN_REGISTER_TYPE_WITH_CODE(PluginName, plugin_name, CODE)	\
 										\
@@ -169,18 +169,18 @@
 	return plugin_name##_type;						\
 }
 
-/*
- * Utility macro used to register plugins
- *
- * use: GTR_PLUGIN_REGISTER_TYPE(PluginName, plugin_name)
+/**
+ * GTR_PLUGIN_REGISTER_TYPE(PluginName, plugin_name):
+ * 
+ * Utility macro used to register plugins.
  */
 #define GTR_PLUGIN_REGISTER_TYPE(PluginName, plugin_name)			\
 	GTR_PLUGIN_REGISTER_TYPE_WITH_CODE(PluginName, plugin_name, ;)
 
-/*
- * Utility macro used to register gobject types in plugins with additional code
+/**
+ * GTR_PLUGIN_DEFINE_TYPE_WITH_CODE(ObjectName, object_name, PARENT_TYPE, CODE):
  *
- * use: GTR_PLUGIN_DEFINE_TYPE_WITH_CODE(ObjectName, object_name, PARENT_TYPE, CODE)
+ * Utility macro used to register gobject types in plugins with additional code.
  */
 #define GTR_PLUGIN_DEFINE_TYPE_WITH_CODE(ObjectName, object_name, PARENT_TYPE, CODE)	\
 										\
@@ -230,10 +230,10 @@
 	return g_define_type_id;						\
 }
 
-/*
- * Utility macro used to register gobject types in plugins
+/**
+ * GTR_PLUGIN_DEFINE_TYPE(ObjectName, object_name, PARENT_TYPE):
  *
- * use: GTR_PLUGIN_DEFINE_TYPE(ObjectName, object_name, PARENT_TYPE)
+ * Utility macro used to register gobject types in plugins.
  */
 #define GTR_PLUGIN_DEFINE_TYPE(ObjectName, object_name, PARENT_TYPE)		\
 	GTR_PLUGIN_DEFINE_TYPE_WITH_CODE(ObjectName, object_name, PARENT_TYPE, ;)

Modified: trunk/src/plugin-system/update-from-gedit.sh
==============================================================================
--- trunk/src/plugin-system/update-from-gedit.sh	(original)
+++ trunk/src/plugin-system/update-from-gedit.sh	Mon Sep 22 09:45:36 2008
@@ -25,6 +25,7 @@
 	-e 's/gedit-plugin-info/plugin-info/g' \
 	-e 's/gedit-plugin/plugin/g' \
 	-e 's/gedit-panel.h/panel.h/g' \
+	-e 's/#include <gedit\/gedit-window.h>/#include "window.h"/g' \
 	-e 's/gedit-window.h/window.h/g' \
 	-e 's/gedit-utils.h/utils.h/g' \
 	-e 's/#include <gedit\/gedit-debug.h>/#include "debug.h"/g' \