From 69464ff40d770523036fabc56244763346f8df49 Mon Sep 17 00:00:00 2001
From: Cosimo Cecchi <cosimoc@gnome.org>
Date: Mon, 16 Jan 2012 10:28:40 -0500
Subject: extension: add some more missing gir annotations

---
 libcaja-extension/caja-column-provider.c        |  6 ++++++
 libcaja-extension/caja-menu-provider.c          | 16 ++++++++++++++++
 libcaja-extension/caja-menu.c                   | 11 +++++++++++
 libcaja-extension/caja-property-page-provider.c |  4 ++--
 4 files changed, 35 insertions(+), 2 deletions(-)

(limited to 'libcaja-extension')

diff --git a/libcaja-extension/caja-column-provider.c b/libcaja-extension/caja-column-provider.c
index 9faf438f..87833c90 100644
--- a/libcaja-extension/caja-column-provider.c
+++ b/libcaja-extension/caja-column-provider.c
@@ -61,6 +61,12 @@ caja_column_provider_get_type (void)
     return type;
 }
 
+/**
+ * caja_column_provider_get_columns:
+ * @provider: a #CajaColumnProvider
+ *
+ * Returns: (element-type CajaColumn) (transfer full): the provided #CajaColumn objects
+ */
 GList *
 caja_column_provider_get_columns (CajaColumnProvider *provider)
 {
diff --git a/libcaja-extension/caja-menu-provider.c b/libcaja-extension/caja-menu-provider.c
index fa2fc0ed..0c47dd13 100644
--- a/libcaja-extension/caja-menu-provider.c
+++ b/libcaja-extension/caja-menu-provider.c
@@ -76,6 +76,14 @@ caja_menu_provider_get_type (void)
     return type;
 }
 
+/**
+ * caja_menu_provider_get_file_items:
+ * @provider: a #CajaMenuProvider
+ * @window: the parent #GtkWidget window
+ * @files: (element-type CajaFileInfo): a list of #CajaFileInfo
+ *
+ * Returns: (element-type CajaMenuItem) (transfer full): the provided list of #CajaMenuItem
+ */
 GList *
 caja_menu_provider_get_file_items (CajaMenuProvider *provider,
                                    GtkWidget *window,
@@ -94,6 +102,14 @@ caja_menu_provider_get_file_items (CajaMenuProvider *provider,
     }
 }
 
+/**
+ * caja_menu_provider_get_background_items:
+ * @provider: a #CajaMenuProvider
+ * @window: the parent #GtkWidget window
+ * @current_folder: the folder for which background items are requested
+ *
+ * Returns: (element-type CajaMenuItem) (transfer full): the provided list of #CajaMenuItem
+ */
 GList *
 caja_menu_provider_get_background_items (CajaMenuProvider *provider,
         GtkWidget *window,
diff --git a/libcaja-extension/caja-menu.c b/libcaja-extension/caja-menu.c
index 5f0c06b4..f6f15f20 100644
--- a/libcaja-extension/caja-menu.c
+++ b/libcaja-extension/caja-menu.c
@@ -44,6 +44,12 @@ caja_menu_append_item (CajaMenu *menu, CajaMenuItem *item)
     menu->priv->item_list = g_list_append (menu->priv->item_list, g_object_ref (item));
 }
 
+/**
+ * caja_menu_get_items:
+ * @menu: a #CajaMenu
+ *
+ * Returns: (element-type CajaMenuItem) (transfer full): the provided #CajaMenuItem list
+ */
 GList *
 caja_menu_get_items (CajaMenu *menu)
 {
@@ -57,6 +63,11 @@ caja_menu_get_items (CajaMenu *menu)
     return item_list;
 }
 
+/**
+ * caja_menu_item_list_free:
+ * @item_list: (element-type CajaMenuItem): a list of #CajaMenuItem
+ *
+ */
 void
 caja_menu_item_list_free (GList *item_list)
 {
diff --git a/libcaja-extension/caja-property-page-provider.c b/libcaja-extension/caja-property-page-provider.c
index 90780a10..cd3fc176 100644
--- a/libcaja-extension/caja-property-page-provider.c
+++ b/libcaja-extension/caja-property-page-provider.c
@@ -65,7 +65,7 @@ caja_property_page_provider_get_type (void)
 /**
  * caja_property_page_provider_get_pages:
  * @provider: a #CajaPropertyPageProvider
- * @files: a #GList of #CajaFileInfo
+ * @files: (element-type CajaFileInfo): a #GList of #CajaFileInfo
  *
  * This function is called by Caja when it wants property page
  * items from the extension.
@@ -73,7 +73,7 @@ caja_property_page_provider_get_type (void)
  * This function is called in the main thread before a property page
  * is shown, so it should return quickly.
  *
- * Returns: A #GList of allocated #CajaPropertyPage items.
+ * Returns: (element-type CajaPropertyPage) (transfer full): A #GList of allocated #CajaPropertyPage items.
  */
 GList *
 caja_property_page_provider_get_pages (CajaPropertyPageProvider *provider,
-- 
cgit v1.2.1