Add GObject introspection annotations to many *_get_* functions

Partial fix for bug #599757.

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

3 files changed, 41 insertions, 1 deletions

diff --git a/lib/ephy-dialog.c b/lib/ephy-dialog.c
index 3d2226d70..f2a577358 100644
--- a/lib/ephy-dialog.c
+++ b/lib/ephy-dialog.c
@@ -1263,6 +1263,11 @@ ephy_dialog_run (EphyDialog *dialog)
 	return gtk_dialog_run (GTK_DIALOG (dialog->priv->dialog));
 }
 
+/**
+ * ephy_dialog_get_control:
+ *
+ * Return value: (transfer none):
+ **/
 GtkWidget *
 ephy_dialog_get_control (EphyDialog *dialog,
 			 const char *property_id)
@@ -1379,6 +1384,11 @@ ephy_dialog_finalize (GObject *object)
 	G_OBJECT_CLASS (parent_class)->finalize (object);
 }
 
+/**
+ * ephy_dialog_get_parent:
+ *
+ * Return value: (transfer none):
+ **/
 GtkWidget *
 ephy_dialog_get_parent (EphyDialog *dialog)
 {
diff --git a/lib/ephy-node-db.c b/lib/ephy-node-db.c
index 4e421f20e..2a9563198 100644
--- a/lib/ephy-node-db.c
+++ b/lib/ephy-node-db.c
@@ -197,7 +197,7 @@ ephy_node_db_set_immutable (EphyNodeDb *db, gboolean immutable)
  *
  * Returns the #EphyNode with id @id from @db, or %NULL if no such id exists.
  *
- * Return value: an #EphyNode
+ * Return value: (transfer none): an #EphyNode
  **/
 EphyNode *
 ephy_node_db_get_node_from_id (EphyNodeDb *db, guint id)
diff --git a/lib/ephy-node.c b/lib/ephy-node.c
index 9dcbfa16e..2fec271d2 100644
--- a/lib/ephy-node.c
+++ b/lib/ephy-node.c
@@ -380,6 +380,11 @@ ephy_node_new_with_id (EphyNodeDb *db, guint reserved_id)
 	return node;
 }
 
+/**
+ * ephy_node_get_db:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNodeDb *
 ephy_node_get_db (EphyNode *node)
 {
@@ -758,6 +763,11 @@ ephy_node_get_property_float (EphyNode *node,
 	return retval;
 }
 
+/**
+ * ephy_node_get_property_node:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_node_get_property_node (EphyNode *node,
 			     guint property_id)
@@ -1208,6 +1218,11 @@ ephy_node_reorder_children (EphyNode *node,
 	ephy_node_emit_signal (node, EPHY_NODE_CHILDREN_REORDERED, new_order);
 }
 
+/**
+ * ephy_node_get_children:
+ *
+ * Return value: (array) (element-type EphyNode) (transfer none):
+ **/
 GPtrArray *
 ephy_node_get_children (EphyNode *node)
 {
@@ -1228,6 +1243,11 @@ ephy_node_get_n_children (EphyNode *node)
 	return ret;
 }
 
+/**
+ * ephy_node_get_nth_child:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_node_get_nth_child (EphyNode *node,
 		         guint n)
@@ -1276,6 +1296,11 @@ ephy_node_get_child_index (EphyNode *node,
 	return ret;
 }
 
+/**
+ * ephy_node_get_next_child:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_node_get_next_child (EphyNode *node,
 			  EphyNode *child)
@@ -1297,6 +1322,11 @@ ephy_node_get_next_child (EphyNode *node,
 	return ret;
 }
 
+/**
+ * ephy_node_get_previous_child:
+ *
+ * Return value: (transfer none):
+ **/
 EphyNode *
 ephy_node_get_previous_child (EphyNode *node,
 			      EphyNode *child)