[libgnomekbd] A number of annotations for introspection purposes

[Sergey V. Udaltsov <svu src gnome org>]

commit 1a0cda3c571e3b1febe5231f3ebca31b956835fd
Author: Sergey V. Udaltsov <svu gnome org>
Date:   Sat Dec 25 01:46:25 2010 +0000

    A number of annotations for introspection purposes
    
    There were some warning, now they're gone

 libgnomekbd/gkbd-desktop-config.c           |    4 ++++
 libgnomekbd/gkbd-indicator-config.c         |    4 ++++
 libgnomekbd/gkbd-indicator-plugin-manager.c |    4 ++++
 libgnomekbd/gkbd-indicator.c                |   20 ++++++++++++++------
 libgnomekbd/gkbd-keyboard-config.c          |    8 ++++++++
 libgnomekbd/gkbd-keyboard-drawing.h         |    2 --
 libgnomekbd/gkbd-status.c                   |    4 ++++
 libgnomekbd/gkbd-util.c                     |    8 ++++++++
 8 files changed, 46 insertions(+), 8 deletions(-)
---
diff --git a/libgnomekbd/gkbd-desktop-config.c b/libgnomekbd/gkbd-desktop-config.c
index b0b0ff3..7b4b30d 100644
--- a/libgnomekbd/gkbd-desktop-config.c
+++ b/libgnomekbd/gkbd-desktop-config.c
@@ -240,6 +240,10 @@ gkbd_desktop_config_restore_group (GkbdDesktopConfig * config)
 	xkl_engine_lock_group (config->engine, group);
 }
 
+/**
+ * gkbd_desktop_config_start_listen:
+ * @func: (scope notified): a function to call when settings are changed
+ */
 void
 gkbd_desktop_config_start_listen (GkbdDesktopConfig * config,
 				  GCallback func, gpointer user_data)
diff --git a/libgnomekbd/gkbd-indicator-config.c b/libgnomekbd/gkbd-indicator-config.c
index d6cae01..558b590 100644
--- a/libgnomekbd/gkbd-indicator-config.c
+++ b/libgnomekbd/gkbd-indicator-config.c
@@ -320,6 +320,10 @@ gkbd_indicator_config_activate (GkbdIndicatorConfig * ind_config)
 					      secondary_groups_mask);
 }
 
+/**
+ * gkbd_indicator_config_start_listen:
+ * @func: (scope notified): a function to call when settings are changed
+ */
 void
 gkbd_indicator_config_start_listen (GkbdIndicatorConfig *
 				    ind_config,
diff --git a/libgnomekbd/gkbd-indicator-plugin-manager.c b/libgnomekbd/gkbd-indicator-plugin-manager.c
index 9c55d66..53aa35b 100644
--- a/libgnomekbd/gkbd-indicator-plugin-manager.c
+++ b/libgnomekbd/gkbd-indicator-plugin-manager.c
@@ -357,6 +357,10 @@ int
 	return -1;
 }
 
+/**
+ * gkbd_indicator_plugin_manager_decorate_widget:
+ * Returns: (transfer full): A widget to use
+ */
 GtkWidget
     * gkbd_indicator_plugin_manager_decorate_widget
     (GkbdIndicatorPluginManager * manager, GtkWidget * widget,
diff --git a/libgnomekbd/gkbd-indicator.c b/libgnomekbd/gkbd-indicator.c
index b930c57..58f21ca 100644
--- a/libgnomekbd/gkbd-indicator.c
+++ b/libgnomekbd/gkbd-indicator.c
@@ -117,7 +117,8 @@ gkbd_indicator_load_images ()
 							    GTK_BUTTONS_OK,
 							    _
 							    ("There was an error loading an image: %s"),
-							    gerror->message);
+							    gerror->
+							    message);
 				g_signal_connect (G_OBJECT (dialog),
 						  "response",
 						  G_CALLBACK
@@ -410,10 +411,8 @@ gkbd_indicator_prepare_drawing (GkbdIndicator * gki, int group)
 		    gkbd_indicator_extract_layout_name (group,
 							globals.engine,
 							&globals.kbd_cfg,
-							globals.
-							short_group_names,
-							globals.
-							full_group_names);
+							globals.short_group_names,
+							globals.full_group_names);
 
 		lbl_title =
 		    gkbd_indicator_create_label_title (group,
@@ -602,7 +601,8 @@ gkbd_indicator_set_current_page (GkbdIndicator * gki)
 	cur_state = xkl_engine_get_current_state (globals.engine);
 	if (cur_state->group >= 0)
 		gkbd_indicator_set_current_page_for_group (gki,
-							   cur_state->group);
+							   cur_state->
+							   group);
 }
 
 void
@@ -898,6 +898,10 @@ gkbd_indicator_get_xkl_engine ()
 	return globals.engine;
 }
 
+/**
+ * gkbd_indicator_get_group_names:
+ * Returns: (transfer none): List of group names
+ */
 gchar **
 gkbd_indicator_get_group_names ()
 {
@@ -950,6 +954,10 @@ gkbd_indicator_plugin_container_reinit_ui (GkbdIndicatorPluginContainer *
 	} NextIndicator ();
 }
 
+/**
+ * gkbd_indicator_plugin_load_localized_group_names:
+ * Returns: (transfer none): all group names
+ */
 gchar **gkbd_indicator_plugin_load_localized_group_names
     (GkbdIndicatorPluginContainer * pc) {
 	return globals.full_group_names;
diff --git a/libgnomekbd/gkbd-keyboard-config.c b/libgnomekbd/gkbd-keyboard-config.c
index 3074ce0..5f0a068 100644
--- a/libgnomekbd/gkbd-keyboard-config.c
+++ b/libgnomekbd/gkbd-keyboard-config.c
@@ -593,6 +593,10 @@ gkbd_keyboard_config_activate (GkbdKeyboardConfig * kbd_config)
 	return rv;
 }
 
+/**
+ * gkbd_keyboard_config_start_listen:
+ * @func: (scope notified): a function to call when settings are changed
+ */
 void
 gkbd_keyboard_config_start_listen (GkbdKeyboardConfig * kbd_config,
 				   GCallback func, gpointer user_data)
@@ -705,6 +709,10 @@ gkbd_keyboard_config_to_string (const GkbdKeyboardConfig * config)
 	return result;
 }
 
+/**
+ * gkbd_keyboard_config_add_default_switch_option_if_necessary:
+ * Returns: (transfer full): List of options
+ */
 gchar **
 gkbd_keyboard_config_add_default_switch_option_if_necessary (gchar **
 							     layouts_list,
diff --git a/libgnomekbd/gkbd-keyboard-drawing.h b/libgnomekbd/gkbd-keyboard-drawing.h
index 4540580..9b4492f 100644
--- a/libgnomekbd/gkbd-keyboard-drawing.h
+++ b/libgnomekbd/gkbd-keyboard-drawing.h
@@ -169,8 +169,6 @@ struct _GkbdKeyboardDrawingClass {
 GType gkbd_keyboard_drawing_get_type (void);
 GtkWidget *gkbd_keyboard_drawing_new (void);
 
-GdkPixbuf *gkbd_keyboard_drawing_get_pixbuf (GkbdKeyboardDrawing *
-					     kbdrawing);
 gboolean gkbd_keyboard_drawing_render (GkbdKeyboardDrawing * kbdrawing,
 				       cairo_t * cr,
 				       PangoLayout * layout,
diff --git a/libgnomekbd/gkbd-status.c b/libgnomekbd/gkbd-status.c
index 0c05a70..0e0b22c 100644
--- a/libgnomekbd/gkbd-status.c
+++ b/libgnomekbd/gkbd-status.c
@@ -838,6 +838,10 @@ gkbd_status_get_xkl_engine ()
 	return globals.engine;
 }
 
+/**
+ * gkbd_status_get_group_names:
+ * Returns: (transfer none): List of group names
+ */
 gchar **
 gkbd_status_get_group_names ()
 {
diff --git a/libgnomekbd/gkbd-util.c b/libgnomekbd/gkbd-util.c
index 25867b3..2b3e6c7 100644
--- a/libgnomekbd/gkbd-util.c
+++ b/libgnomekbd/gkbd-util.c
@@ -50,6 +50,10 @@ const gchar GKBD_PREVIEW_CONFIG_KEY_Y[] = "y";
 const gchar GKBD_PREVIEW_CONFIG_KEY_WIDTH[] = "width";
 const gchar GKBD_PREVIEW_CONFIG_KEY_HEIGHT[] = "height";
 
+/**
+ * gkbd_preview_load_position:
+ * Returns: (transfer full): A rectangle to use
+ */
 GdkRectangle *
 gkbd_preview_load_position (void)
 {
@@ -124,6 +128,10 @@ gkbd_strv_remove (gchar ** arr, const gchar * element)
 	return FALSE;
 }
 
+/**
+ * gkbd_strv_append:
+ * Returns: (transfer full): Append string to strv array
+ */
 gchar **
 gkbd_strv_append (gchar ** arr, gchar * element)
 {