[nautilus] extension: add some more missing gir annotations



commit e79c28b48008ed5e94763417b4a68b86ffcfd919
Author: Cosimo Cecchi <cosimoc gnome org>
Date:   Mon Jan 16 10:28:40 2012 -0500

    extension: add some more missing gir annotations

 libnautilus-extension/nautilus-column-provider.c   |    6 ++++++
 libnautilus-extension/nautilus-menu-provider.c     |   16 ++++++++++++++++
 libnautilus-extension/nautilus-menu.c              |   11 +++++++++++
 .../nautilus-property-page-provider.c              |    4 ++--
 4 files changed, 35 insertions(+), 2 deletions(-)
---
diff --git a/libnautilus-extension/nautilus-column-provider.c b/libnautilus-extension/nautilus-column-provider.c
index 67017d6..e918c13 100644
--- a/libnautilus-extension/nautilus-column-provider.c
+++ b/libnautilus-extension/nautilus-column-provider.c
@@ -59,6 +59,12 @@ nautilus_column_provider_get_type (void)
 	return type;
 }
 
+/**
+ * nautilus_column_provider_get_columns:
+ * @provider: a #NautilusColumnProvider
+ *
+ * Returns: (element-type NautilusColumn) (transfer full): the provided #NautilusColumn objects
+ */
 GList *
 nautilus_column_provider_get_columns (NautilusColumnProvider *provider)
 {
diff --git a/libnautilus-extension/nautilus-menu-provider.c b/libnautilus-extension/nautilus-menu-provider.c
index 83bca15..3b89c75 100644
--- a/libnautilus-extension/nautilus-menu-provider.c
+++ b/libnautilus-extension/nautilus-menu-provider.c
@@ -74,6 +74,14 @@ nautilus_menu_provider_get_type (void)
 	return type;
 }
 
+/**
+ * nautilus_menu_provider_get_file_items:
+ * @provider: a #NautilusMenuProvider
+ * @window: the parent #GtkWidget window
+ * @files: (element-type NautilusFileInfo): a list of #NautilusFileInfo
+ *
+ * Returns: (element-type NautilusMenuItem) (transfer full): the provided list of #NautilusMenuItem
+ */
 GList *
 nautilus_menu_provider_get_file_items (NautilusMenuProvider *provider,
 				       GtkWidget *window,
@@ -89,6 +97,14 @@ nautilus_menu_provider_get_file_items (NautilusMenuProvider *provider,
 	}
 }
 
+/**
+ * nautilus_menu_provider_get_background_items:
+ * @provider: a #NautilusMenuProvider
+ * @window: the parent #GtkWidget window
+ * @current_folder: the folder for which background items are requested
+ *
+ * Returns: (element-type NautilusMenuItem) (transfer full): the provided list of #NautilusMenuItem
+ */
 GList *
 nautilus_menu_provider_get_background_items (NautilusMenuProvider *provider,
 					     GtkWidget *window,
diff --git a/libnautilus-extension/nautilus-menu.c b/libnautilus-extension/nautilus-menu.c
index 546b81e..df2e61f 100644
--- a/libnautilus-extension/nautilus-menu.c
+++ b/libnautilus-extension/nautilus-menu.c
@@ -43,6 +43,12 @@ nautilus_menu_append_item (NautilusMenu *menu, NautilusMenuItem *item)
 	menu->priv->item_list = g_list_append (menu->priv->item_list, g_object_ref (item));
 }
 
+/**
+ * nautilus_menu_get_items:
+ * @menu: a #NautilusMenu
+ *
+ * Returns: (element-type NautilusMenuItem) (transfer full): the provided #NautilusMenuItem list
+ */
 GList *
 nautilus_menu_get_items (NautilusMenu *menu)
 {
@@ -56,6 +62,11 @@ nautilus_menu_get_items (NautilusMenu *menu)
 	return item_list;
 }
 
+/**
+ * nautilus_menu_item_list_free:
+ * @item_list: (element-type NautilusMenuItem): a list of #NautilusMenuItem
+ *
+ */
 void
 nautilus_menu_item_list_free (GList *item_list)
 {
diff --git a/libnautilus-extension/nautilus-property-page-provider.c b/libnautilus-extension/nautilus-property-page-provider.c
index eb07596..7739b60 100644
--- a/libnautilus-extension/nautilus-property-page-provider.c
+++ b/libnautilus-extension/nautilus-property-page-provider.c
@@ -63,7 +63,7 @@ nautilus_property_page_provider_get_type (void)
 /**
  * nautilus_property_page_provider_get_pages:
  * @provider: a #NautilusPropertyPageProvider
- * @files: a #GList of #NautilusFileInfo
+ * @files: (element-type NautilusFileInfo): a #GList of #NautilusFileInfo
  *
  * This function is called by Nautilus when it wants property page
  * items from the extension.
@@ -71,7 +71,7 @@ nautilus_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 #NautilusPropertyPage items.
+ * Returns: (element-type NautilusPropertyPage) (transfer full): A #GList of allocated #NautilusPropertyPage items.
  */
 GList *
 nautilus_property_page_provider_get_pages (NautilusPropertyPageProvider *provider,



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]