Add GObject introspection annotations to many *_get_* functions

Partial fix for bug #599757.

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

8 files changed, 100 insertions, 12 deletions

diff --git a/src/bookmarks/ephy-bookmarks.c b/src/bookmarks/ephy-bookmarks.c
index 3b7147a74..507426978 100644
--- a/src/bookmarks/ephy-bookmarks.c
+++ b/src/bookmarks/ephy-bookmarks.c
@@ -1937,30 +1937,55 @@ ephy_bookmarks_unset_keyword (EphyBookmarks *eb,
 	g_signal_emit (G_OBJECT (eb), ephy_bookmarks_signals[TREE_CHANGED], 0);
 }
 
+/**
+ * ephy_bookmarks_get_smart_bookmarks:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_bookmarks_get_smart_bookmarks (EphyBookmarks *eb)
 {
 	return eb->priv->smartbookmarks;
 }
 
+/**
+ * ephy_bookmarks_get_keywords:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_bookmarks_get_keywords (EphyBookmarks *eb)
 {
 	return eb->priv->keywords;
 }
 
+/**
+ * ephy_bookmarks_get_bookmarks:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_bookmarks_get_bookmarks (EphyBookmarks *eb)
 {
 	return eb->priv->bookmarks;
 }
 
+/**
+ * ephy_bookmarks_get_favorites:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_bookmarks_get_favorites (EphyBookmarks *eb)
 {
 	return eb->priv->favorites;
 }
 
+/**
+ * ephy_bookmarks_get_local:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_bookmarks_get_local (EphyBookmarks *eb)
 {
@@ -1971,12 +1996,22 @@ ephy_bookmarks_get_local (EphyBookmarks *eb)
 #endif
 }
 
+/**
+ * ephy_bookmarks_get_not_categorized:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_bookmarks_get_not_categorized (EphyBookmarks *eb)
 {
 	return eb->priv->notcategorized;
 }
 
+/**
+ * ephy_bookmarks_get_from_id:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_bookmarks_get_from_id (EphyBookmarks *eb, long id)
 {
diff --git a/src/ephy-extensions-manager.c b/src/ephy-extensions-manager.c
index 979e6d632..cb0157117 100644
--- a/src/ephy-extensions-manager.c
+++ b/src/ephy-extensions-manager.c
@@ -230,7 +230,8 @@ ephy_extensions_manager_register (EphyExtensionsManager *manager,
  *
  * Returns the list of known extensions.
  *
- * Returns: a list of #EphyExtensionInfo
+ * Returns: (element-type EphyEmbed) (transfer container): a list of
+ *          #EphyExtensionInfo
  **/
 GList *
 ephy_extensions_manager_get_extensions (EphyExtensionsManager *manager)
diff --git a/src/ephy-notebook.c b/src/ephy-notebook.c
index 253e3a0d9..0ea261d11 100644
--- a/src/ephy-notebook.c
+++ b/src/ephy-notebook.c
@@ -679,6 +679,11 @@ ephy_notebook_set_show_tabs (EphyNotebook *nb,
 	update_tabs_visibility (nb, FALSE);
 }
 
+/**
+ * ephy_notebook_get_focused_pages:
+ *
+ * Return value: (transfer none):
+ **/
 GList *
 ephy_notebook_get_focused_pages (EphyNotebook *nb)
 {
diff --git a/src/ephy-session.c b/src/ephy-session.c
index e77d12b73..3919c6c1f 100644
--- a/src/ephy-session.c
+++ b/src/ephy-session.c
@@ -1601,7 +1601,8 @@ ephy_session_load (EphySession *session,
  * ephy_session_get_windows:
  * @session: the #EphySession
  *
- * Returns: the list of open #EphyWindow:s.
+ * Returns: (element-type EphyWindow) (transfer container): the list of
+ *          open #EphyWindow:s.
  **/
 GList *
 ephy_session_get_windows (EphySession *session)
@@ -1659,7 +1660,8 @@ ephy_session_remove_window (EphySession *session,
  * need to take an action (like opening an url) on
  * a window but you dont have a target window.
  *
- * Return value: the current active non-popup browser window, or NULL of there is none.
+ * Return value: (transfer none): the current active non-popup browser
+ *               window, or NULL of there is none.
  **/
 EphyWindow *
 ephy_session_get_active_window (EphySession *session)
diff --git a/src/ephy-shell.c b/src/ephy-shell.c
index b3964cb5e..3a42fd239 100644
--- a/src/ephy-shell.c
+++ b/src/ephy-shell.c
@@ -359,7 +359,7 @@ ephy_shell_finalize (GObject *object)
  *
  * Retrieve the default #EphyShell object
  *
- * Return value: the default #EphyShell
+ * Return value: (transfer none): the default #EphyShell
  **/
 EphyShell *
 ephy_shell_get_default (void)
@@ -589,7 +589,7 @@ ephy_shell_new_tab (EphyShell *shell,
  *
  * Returns current session.
  *
- * Return value: the current session.
+ * Return value: (transfer none): the current session.
  **/
 GObject *
 ephy_shell_get_session (EphyShell *shell)
@@ -639,6 +639,11 @@ ephy_shell_get_lockdown (EphyShell *shell)
 	return G_OBJECT (shell->priv->session);
 }
 
+/**
+ * ephy_shell_get_bookmarks:
+ *
+ * Return value: (transfer none):
+ **/
 EphyBookmarks *
 ephy_shell_get_bookmarks (EphyShell *shell)
 {
@@ -650,6 +655,11 @@ ephy_shell_get_bookmarks (EphyShell *shell)
 	return shell->priv->bookmarks;
 }
 
+/**
+ * ephy_shell_get_toolbars_model:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_shell_get_toolbars_model (EphyShell *shell, gboolean fullscreen)
 {
@@ -696,6 +706,11 @@ ephy_shell_get_toolbars_model (EphyShell *shell, gboolean fullscreen)
 	}
 }
 
+/**
+ * ephy_shell_get_extensions_manager:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_shell_get_extensions_manager (EphyShell *es)
 {
@@ -717,6 +732,11 @@ ephy_shell_get_extensions_manager (EphyShell *es)
 	return G_OBJECT (es->priv->extensions_manager);
 }
 
+/**
+ * ephy_shell_get_net_monitor:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_shell_get_net_monitor (EphyShell *shell)
 {
@@ -760,6 +780,11 @@ toolwindow_hide_cb (GtkWidget *widget, EphyShell *es)
 	g_object_unref (ephy_shell);
 }
 
+/**
+ * ephy_shell_get_bookmarks_editor:
+ *
+ * Return value: (transfer none):
+ **/
 GtkWidget *
 ephy_shell_get_bookmarks_editor (EphyShell *shell)
 {
@@ -780,6 +805,11 @@ ephy_shell_get_bookmarks_editor (EphyShell *shell)
 	return shell->priv->bme;
 }
 
+/**
+ * ephy_shell_get_history_window:
+ *
+ * Return value: (transfer none):
+ **/
 GtkWidget *
 ephy_shell_get_history_window (EphyShell *shell)
 {
@@ -801,6 +831,11 @@ ephy_shell_get_history_window (EphyShell *shell)
 	return shell->priv->history_window;
 }
 
+/**
+ * ephy_shell_get_pdm_dialog:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_shell_get_pdm_dialog (EphyShell *shell)
 {
@@ -819,6 +854,11 @@ ephy_shell_get_pdm_dialog (EphyShell *shell)
 	return shell->priv->pdm_dialog;
 }
 
+/**
+ * ephy_shell_get_prefs_dialog:
+ *
+ * Return value: (transfer none):
+ **/
 GObject *
 ephy_shell_get_prefs_dialog (EphyShell *shell)
 {
diff --git a/src/ephy-statusbar.c b/src/ephy-statusbar.c
index a30d57f39..c3c7abbab 100644
--- a/src/ephy-statusbar.c
+++ b/src/ephy-statusbar.c
@@ -342,7 +342,7 @@ ephy_statusbar_remove_widget (EphyStatusbar *statusbar,
  * ephy_statusbar_get_security_frame:
  * @statusbar: an #EphyStatusbar
  *
- * Return value: the statusbar's lock icon frame
+ * Return value: (transfer none): the statusbar's lock icon frame
  */
 GtkWidget *
 ephy_statusbar_get_security_frame (EphyStatusbar *statusbar)
diff --git a/src/ephy-toolbar.c b/src/ephy-toolbar.c
index 7442bc225..3cd3eee16 100644
--- a/src/ephy-toolbar.c
+++ b/src/ephy-toolbar.c
@@ -358,6 +358,11 @@ ephy_toolbar_set_window (EphyToolbar *toolbar,
 
 /* public functions */
 
+/**
+ * ephy_toolbar_get_action_group
+ *
+ * Return value: (transfer none):
+ **/
 GtkActionGroup *
 ephy_toolbar_get_action_group (EphyToolbar *toolbar)
 {
diff --git a/src/ephy-window.c b/src/ephy-window.c
index a734e94f9..5991190f7 100644
--- a/src/ephy-window.c
+++ b/src/ephy-window.c
@@ -3884,7 +3884,7 @@ ephy_window_new_with_chrome (EphyWebViewChrome chrome,
  *
  * Returns this window's UI manager.
  *
- * Return value: an #GtkUIManager
+ * Return value: (transfer none): an #GtkUIManager
  **/
 GObject *
 ephy_window_get_ui_manager (EphyWindow *window)
@@ -3900,7 +3900,7 @@ ephy_window_get_ui_manager (EphyWindow *window)
  *
  * Returns this window's toolbar as an #EggEditableToolbar.
  *
- * Return value: an #EggEditableToolbar
+ * Return value: (transfer none): an #EggEditableToolbar
  **/
 GtkWidget *
 ephy_window_get_toolbar (EphyWindow *window)
@@ -3916,7 +3916,7 @@ ephy_window_get_toolbar (EphyWindow *window)
  *
  * Returns the #GtkNotebook used by this window.
  *
- * Return value: the @window's #GtkNotebook
+ * Return value: (transfer none): the @window's #GtkNotebook
  **/
 GtkWidget *
 ephy_window_get_notebook (EphyWindow *window)
@@ -3932,7 +3932,7 @@ ephy_window_get_notebook (EphyWindow *window)
  *
  * Returns the #EphyFindToolbar used by this window.
  *
- * Return value: the @window's #EphyFindToolbar
+ * Return value: (transfer none): the @window's #EphyFindToolbar
  **/
 GtkWidget *
 ephy_window_get_find_toolbar (EphyWindow *window)
@@ -3948,7 +3948,7 @@ ephy_window_get_find_toolbar (EphyWindow *window)
  *
  * Returns this window's statusbar as an #EphyStatusbar.
  *
- * Return value: This window's statusbar
+ * Return value: (transfer none): This window's statusbar
  **/
 GtkWidget *
 ephy_window_get_statusbar (EphyWindow *window)
@@ -4196,7 +4196,7 @@ ephy_window_get_is_print_preview (EphyWindow *window)
  * Returns the #EphyEmbedEvent for the current context menu.
  * Use this to get the event from the action callback.
  *
- * Return value: an #EphyEmbedEvent, or %NULL
+ * Return value: (transfer none): an #EphyEmbedEvent, or %NULL
  **/
 EphyEmbedEvent *
 ephy_window_get_context_event (EphyWindow *window)