Add GObject introspection annotations to many *_get_* functions

Partial fix for bug #599757.

Signed-off-by: Xan Lopez <xan@gnome.org>

6 files changed, 71 insertions, 13 deletions

diff --git a/embed/ephy-embed-container.c b/embed/ephy-embed-container.c
index 1a55eb66a..50d1c143c 100644
--- a/embed/ephy-embed-container.c
+++ b/embed/ephy-embed-container.c
@@ -150,7 +150,7 @@ ephy_embed_container_remove_child (EphyEmbedContainer *container,
  *
  * Returns @container's active #EphyEmbed.
  *
- * Return value: @container's active child
+ * Return value: (transfer none): @container's active child
  **/
 EphyEmbed *
 ephy_embed_container_get_active_child (EphyEmbedContainer *container)
@@ -169,7 +169,8 @@ ephy_embed_container_get_active_child (EphyEmbedContainer *container)
  *
  * Returns the list of #EphyEmbed:s in the container.
  *
- * Return value: a newly-allocated list of #EphyEmbed:s
+ * Return value: (element-type EphyEmbed) (transfer container):
+ *               a newly-allocated list of #EphyEmbed:s
  */
 GList *
 ephy_embed_container_get_children (EphyEmbedContainer *container)
diff --git a/embed/ephy-embed-persist.c b/embed/ephy-embed-persist.c
index e78314970..2c82c0381 100644
--- a/embed/ephy-embed-persist.c
+++ b/embed/ephy-embed-persist.c
@@ -256,7 +256,8 @@ ephy_embed_persist_get_dest (EphyEmbedPersist *persist)
  *
  * Returns the #EphyEmbed from which @persist will download.
  *
- * Return value: the #EphyEmbed from which @persist will download
+ * Return value: (transfer none): the #EphyEmbed from which @persist
+ *               will download
  **/
 EphyEmbed *
 ephy_embed_persist_get_embed (EphyEmbedPersist *persist)
@@ -289,7 +290,8 @@ ephy_embed_persist_get_fc_title (EphyEmbedPersist *persist)
  * Returns the #EphyWindow which should serve as a parent for @persist's
  * filechooser.
  *
- * Return value: the #EphyWindow parent for @persist's filechooser
+ * Return value: (transfer none): the #EphyWindow parent for @persist's
+ *               filechooser
  **/
 GtkWindow *
 ephy_embed_persist_get_fc_parent (EphyEmbedPersist *persist)
diff --git a/embed/ephy-embed-shell.c b/embed/ephy-embed-shell.c
index e68618ec8..d8650a50b 100644
--- a/embed/ephy-embed-shell.c
+++ b/embed/ephy-embed-shell.c
@@ -156,7 +156,7 @@ ephy_embed_shell_finalize (GObject *object)
  *
  * Returns the favicons cache.
  *
- * Return value: the favicons cache
+ * Return value: (transfer none): the favicons cache
  **/
 GObject *
 ephy_embed_shell_get_favicon_cache (EphyEmbedShell *shell)
@@ -171,6 +171,11 @@ ephy_embed_shell_get_favicon_cache (EphyEmbedShell *shell)
 	return G_OBJECT (shell->priv->favicon_cache);
 }
 
+/**
+ * ephy_embed_shell_get_global_history:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_embed_shell_get_global_history (EphyEmbedShell *shell)
 {
@@ -184,6 +189,11 @@ ephy_embed_shell_get_global_history (EphyEmbedShell *shell)
 	return G_OBJECT (shell->priv->global_history);
 }
 
+/**
+ * ephy_embed_shell_get_downloader_view:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_embed_shell_get_downloader_view (EphyEmbedShell *shell)
 {
@@ -202,6 +212,11 @@ ephy_embed_shell_get_downloader_view (EphyEmbedShell *shell)
 	return G_OBJECT (shell->priv->downloader_view);
 }
 
+/**
+ * ephy_embed_shell_get_downloader_view_nocreate:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_embed_shell_get_downloader_view_nocreate (EphyEmbedShell *shell)
 {
@@ -254,6 +269,11 @@ impl_get_embed_single (EphyEmbedShell *shell)
 	return G_OBJECT (shell->priv->embed_single);
 }
 
+/**
+ * ephy_embed_shell_get_embed_single:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_embed_shell_get_embed_single (EphyEmbedShell *shell)
 {
@@ -262,6 +282,11 @@ ephy_embed_shell_get_embed_single (EphyEmbedShell *shell)
 	return klass->get_embed_single (shell);
 }
 
+/**
+ * ephy_embed_shell_get_encodings:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_embed_shell_get_encodings (EphyEmbedShell *shell)
 {
@@ -345,7 +370,7 @@ ephy_embed_shell_class_init (EphyEmbedShellClass *klass)
  *
  * Retrieves the default #EphyEmbedShell object
  *
- * Return value: the default #EphyEmbedShell
+ * Return value: (transfer none): the default #EphyEmbedShell
  **/
 EphyEmbedShell *
 ephy_embed_shell_get_default (void)
@@ -359,7 +384,7 @@ ephy_embed_shell_get_default (void)
  *
  * Returns the adblock manager.
  *
- * Return value: the adblock manager
+ * Return value: (transfer none): the adblock manager
  **/
 GObject *
 ephy_embed_shell_get_adblock_manager (EphyEmbedShell *shell)
@@ -404,7 +429,12 @@ ephy_embed_shell_set_page_setup	(EphyEmbedShell *shell,
 	gtk_page_setup_to_file (page_setup, path, NULL);
 	g_free (path);
 }
-		
+
+/**
+ * ephy_embed_shell_get_page_setup:
+ *
+ * Return value: (transfer none):
+ **/
 GtkPageSetup *
 ephy_embed_shell_get_page_setup	(EphyEmbedShell *shell)
 {
@@ -481,7 +511,12 @@ ephy_embed_shell_set_print_settings (EphyEmbedShell *shell,
 	gtk_print_settings_to_file (settings, path, NULL);
 	g_free (path);
 }
-		
+
+/**
+ * ephy_embed_shell_get_print_gettings:
+ *
+ * Return value: (transfer none):
+ **/
 GtkPrintSettings *
 ephy_embed_shell_get_print_settings (EphyEmbedShell *shell)
 {
diff --git a/embed/ephy-embed.c b/embed/ephy-embed.c
index 39543ee9b..ebb5e64e4 100644
--- a/embed/ephy-embed.c
+++ b/embed/ephy-embed.c
@@ -882,7 +882,7 @@ ephy_embed_init (EphyEmbed *embed)
  * 
  * Returns the #EphyWebView wrapped by @embed.
  * 
- * Returns: an #EphyWebView
+ * Returns: (transfer none): an #EphyWebView
  **/
 EphyWebView*
 ephy_embed_get_web_view (EphyEmbed *embed)
diff --git a/embed/ephy-history.c b/embed/ephy-history.c
index 127420a48..ae0e563dc 100644
--- a/embed/ephy-history.c
+++ b/embed/ephy-history.c
@@ -740,6 +740,11 @@ internal_get_host (EphyHistory *eh, const char *url, gboolean create)
 	return host;
 }
 
+/**
+ * ephy_history_get_host:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_history_get_host (EphyHistory *eh, const char *url)
 {
@@ -875,6 +880,11 @@ impl_add_page (EphyHistory *eb,
 	return TRUE;
 }
 
+/**
+ * ephy_history_get_page:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_history_get_page (EphyHistory *eb,
 		       const char *url)
@@ -975,12 +985,22 @@ ephy_history_clear (EphyHistory *gh)
 	g_signal_emit (gh, signals[CLEARED], 0);
 }
 
+/**
+ * ephy_history_get_hosts:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_history_get_hosts (EphyHistory *eb)
 {
 	return eb->priv->hosts;
 }
 
+/**
+ * ephy_history_get_pages:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_history_get_pages (EphyHistory *eb)
 {
diff --git a/embed/ephy-web-view.c b/embed/ephy-web-view.c
index 4fbfa9859..72c511221 100644
--- a/embed/ephy-web-view.c
+++ b/embed/ephy-web-view.c
@@ -1739,7 +1739,7 @@ ephy_web_view_get_icon_address (EphyWebView *view)
  * Returns the view's site icon as a #GdkPixbuf,
  * or %NULL if it is not available.
  *
- * Return value: a the view's site icon
+ * Return value: (transfer none): a the view's site icon
  **/
 GdkPixbuf *
 ephy_web_view_get_icon (EphyWebView *view)
@@ -2008,8 +2008,8 @@ ephy_web_view_get_js_status (EphyWebView *view)
 /**
  * ephy_web_view_get_security_level:
  * @view: an #EphyWebView
- * @level: return value of security level
- * @description: return value of the description of the security level
+ * @level: (out): return value of security level
+ * @description: (out): return value of the description of the security level
  *
  * Fetches the #EphyWebViewSecurityLevel and a string description of the
  * security state of @view.  The description will be a newly-allocated