gegl r2814 - in trunk: . gegl

[ok svn gnome org]

Author: ok
Date: Sat Dec  6 13:33:22 2008
New Revision: 2814
URL: http://svn.gnome.org/viewvc/gegl?rev=2814&view=rev

Log:
* gegl/gegl.h.in: make gegl_node_add_child and gegl_node_remove_child
public API.


Modified:
   trunk/ChangeLog
   trunk/gegl/gegl.h.in

Modified: trunk/gegl/gegl.h.in
==============================================================================
--- trunk/gegl/gegl.h.in	(original)
+++ trunk/gegl/gegl.h.in	Sat Dec  6 13:33:22 2008
@@ -485,7 +485,10 @@
  *
  * Sometimes it is useful to be able to move nodes between graphs or even
  * handle orphaned nods that are not part of a graph. gegl_node_adopt_child
- * and gegl_node_get_parent are provided ot handle such cases.
+ * and gegl_node_get_parent are provided to handle such cases.
+ *
+ * (gegl_node_adopt_child is deprecated, and will be removed in a future
+ * release)
  */
 
 /**
@@ -505,6 +508,33 @@
                                             GeglNode      *child);
 
 /**
+ * gegl_node_add_child:
+ * @graph: a GeglNode (graph)
+ * @child: a GeglNode.
+ *
+ * Make the GeglNode @graph, take a reference on child. This reference
+ * will be dropped when the reference count on the graph reaches zero.
+ *
+ * Returns the child.
+ */
+GeglNode *    gegl_node_add_child           (GeglNode      *graph,
+                                             GeglNode      *child);
+
+/**
+ * gegl_node_remove_child:
+ * @graph: a GeglNode (graph)
+ * @child: a GeglNode.
+ *
+ * Removes a child from a GeglNode. The reference previously held will be
+ * dropped so increase the reference count before removing when reparenting
+ * a child between two graphs.
+ *
+ * Returns the child.
+ */
+GeglNode *    gegl_node_remove_child        (GeglNode      *graph,
+                                             GeglNode      *child);
+
+/**
  * gegl_node_get_parent:
  * @node: a #GeglNode
  *