From 0256c457bc5558d97c98c17ee673923def23a85e Mon Sep 17 00:00:00 2001
From: Diego Escalante Urrelo <descalante@igalia.com>
Date: Wed, 8 Dec 2010 13:07:23 +0100
Subject: introspection: fix wrong and missing annotations

Bug #636790
---
 src/ephy-link.c    | 23 +++++++++++++++++++++++
 src/ephy-toolbar.c |  4 ++--
 2 files changed, 25 insertions(+), 2 deletions(-)

(limited to 'src')

diff --git a/src/ephy-link.c b/src/ephy-link.c
index 49faa52ae..988132826 100644
--- a/src/ephy-link.c
+++ b/src/ephy-link.c
@@ -43,6 +43,18 @@ ephy_link_base_init (gpointer g_class)
 
 	if (!initialised)
 	{
+		/**
+		 * EphyLink::open-link:
+		 * @address: the address of @link
+		 * @embed: #EphyEmbed associated with @link
+		 * @flags: flags for @link
+		 *
+		 * The ::open-link signal is emitted when @link is requested to
+		 * open it's associated @address.
+		 *
+		 * Returns: (transfer none): the #EphyEmbed where @address has
+		 * been handled.
+		 **/
 		signals[OPEN_LINK] = g_signal_new
 			("open-link",
 			 EPHY_TYPE_LINK,
@@ -82,6 +94,17 @@ ephy_link_get_type (void)
 	return type;
 }
 
+/**
+ * ephy_link_open:
+ * @link: an #EphyLink object
+ * @address: the address of @link
+ * @embed: #EphyEmbed associated with @link
+ * @flags: flags for @link
+ *
+ * Triggers @link open action.
+ *
+ * Returns: (transfer none): the #EphyEmbed where @link opened.
+ */
 EphyEmbed *
 ephy_link_open (EphyLink *link,
 		const char *address,
diff --git a/src/ephy-toolbar.c b/src/ephy-toolbar.c
index a6edc29c0..65b515872 100644
--- a/src/ephy-toolbar.c
+++ b/src/ephy-toolbar.c
@@ -353,12 +353,12 @@ ephy_toolbar_set_window (EphyToolbar *toolbar,
 /* public functions */
 
 /**
- * ephy_toolbar_get_action_group
+ * ephy_toolbar_get_action_group:
  * @toolbar: an #EphyToolbar widget
  *
  * Gets the #GtkActionGroup for @toolbar.
  *
- * Return value: (transfer none):
+ * Return value: (transfer none): the #GtkActionGroup associated with @toolbar
  **/
 GtkActionGroup *
 ephy_toolbar_get_action_group (EphyToolbar *toolbar)
-- 
cgit v1.2.3