introspection: fix wrong and missing annotations

Bug #636790

2 files changed, 41 insertions, 10 deletions

diff --git a/lib/ephy-node.c b/lib/ephy-node.c
index 4194705bd..9413074a0 100644
--- a/lib/ephy-node.c
+++ b/lib/ephy-node.c
@@ -1143,6 +1143,14 @@ ephy_node_real_get_child_index (EphyNode *node,
 	return ret;
 }
 
+/**
+ * ephy_node_sort_children:
+ * @node: an #EphyNode
+ * @compare_func: (scope call): function to compare children
+ *
+ * Sorts the children of @node using @compare_func.
+ *
+ **/
 void
 ephy_node_sort_children (EphyNode *node,
 			 GCompareFunc compare_func)
@@ -1353,6 +1361,17 @@ ephy_node_get_previous_child (EphyNode *node,
 	return ret;
 }
 
+/**
+ * ephy_node_signal_connect_object:
+ * @node: an #EphyNode
+ * @type: signal type
+ * @callback: (scope notified): the callback to connect
+ * @object: data to pass to @callback
+ *
+ * Connects a callback function to the @type signal of @node.
+ *
+ * Returns: an identifier for the connected signal
+ **/
 int
 ephy_node_signal_connect_object (EphyNode *node,
 				 EphyNodeSignalType type,
@@ -1414,6 +1433,18 @@ invalidate_matching_signal_data (gpointer key,
 	}
 }
 
+/**
+ * ephy_node_signal_disconnect_object:
+ * @node: an #EphyNode
+ * @type: signal type
+ * @callback: (scope notified): the callback to disconnect
+ * @object: data passed to @callback when it was connected
+ *
+ * Disconnects @callback from @type in @node. @callback is identified by the
+ * @object previously passed in ephy_node_signal_connect_object.
+ *
+ * Returns: the number of signal handlers removed
+ **/
 guint
 ephy_node_signal_disconnect_object (EphyNode *node,
                                     EphyNodeSignalType type,
diff --git a/lib/widgets/ephy-location-entry.c b/lib/widgets/ephy-location-entry.c
index 5b2c9dc0d..9df8fcf9a 100644
--- a/lib/widgets/ephy-location-entry.c
+++ b/lib/widgets/ephy-location-entry.c
@@ -220,7 +220,7 @@ ephy_location_entry_class_init (EphyLocationEntryClass *klass)
 
 	widget_class->style_set = ephy_location_entry_style_set;
 
-    /**
+       /**
 	* EphyLocationEntry::user-changed:
 	* @entry: the object on which the signal is emitted
 	*
@@ -237,7 +237,7 @@ ephy_location_entry_class_init (EphyLocationEntryClass *klass)
 		0,
 		G_TYPE_NONE);
 
-    /**
+       /**
 	* EphyLocationEntry::lock-clicked:
 	* @entry: the object on which the signal is emitted
 	*
@@ -255,14 +255,14 @@ ephy_location_entry_class_init (EphyLocationEntryClass *klass)
 		G_TYPE_NONE,
 		0);
 
-    /**
+       /**
 	* EphyLocationEntry::get-location:
 	* @entry: the object on which the signal is emitted
 	* Returns: the current page address as a string
 	*
-	* For drag and drop purposes, the location bar will request you the real
-	* address of where it is pointing to. The signal handler for this function
-	* should return the address of the currently loaded site.
+	* For drag and drop purposes, the location bar will request you the
+	* real address of where it is pointing to. The signal handler for this
+	* function should return the address of the currently loaded site.
 	*
 	*/
 	signals[GET_LOCATION] = g_signal_new (
@@ -275,14 +275,14 @@ ephy_location_entry_class_init (EphyLocationEntryClass *klass)
 		0,
 		G_TYPE_NONE);
 
-    /**
+       /**
 	* EphyLocationEntry::get-title:
 	* @entry: the object on which the signal is emitted
 	* Returns: the current page title as a string
 	*
-	* For drag and drop purposes, the location bar will request you the title
-	* of where it is pointing to. The signal handler for this function
-	* should return the title of the currently loaded site.
+	* For drag and drop purposes, the location bar will request you the
+	* title of where it is pointing to. The signal handler for this
+	* function should return the title of the currently loaded site.
 	*
 	*/
 	signals[GET_TITLE] = g_signal_new (