From 33c39344f54d57117f8153289c2a31246d8cd0d8 Mon Sep 17 00:00:00 2001
From: Carlos Lopez <genetita@gmail.com>
Date: Sat, 19 Jun 2010 12:01:44 +0200
Subject: [PATCH] Documentation

---
 synfig-core/src/synfig/node.h | 34 +++++++++++++++++++++++++++-------
 1 file changed, 27 insertions(+), 7 deletions(-)

diff --git a/synfig-core/src/synfig/node.h b/synfig-core/src/synfig/node.h
index 6bc15fd..ad67502 100644
--- a/synfig-core/src/synfig/node.h
+++ b/synfig-core/src/synfig/node.h
@@ -1,6 +1,9 @@
 /* === S Y N F I G ========================================================= */
 /*!	\file node.h
-**	\brief Template Header
+**	\brief Base class for Layers and Value Nodes.
+**	It defines the base members for the parent - child relationship,
+**	the times where the node is modified and the handling of
+**	the GUID on deletion and changing.
 **
 **	$Id$
 **
@@ -49,6 +52,11 @@
 
 namespace synfig {
 
+//!\brief TimePoint class: holds the time and the before and after interpolation mode
+/**
+ * It includes a GUID, to make it unique
+ * \see guid.h interpolation.h
+**/
 class TimePoint
 {
 	GUID guid;
@@ -78,6 +86,9 @@ public:
 	void set_before(Interpolation x) { before=x; }
 	void set_after(Interpolation x) { after=x; }
 
+	//! Modify the TimePoint based on the values of \x "merging"
+	//! the interpolations. Used to insert a Time Point in a Time Points Set
+	//! \see TimePointSet::iterator TimePointSet::insert(const TimePoint& x)
 	void absorb(const TimePoint& x);
 }; // END of class TimePoint
 
@@ -164,7 +175,7 @@ private:
 	/*! \note The second parameter is the *OLD* guid! */
 	sigc::signal<void,GUID> signal_guid_changed_;
 
-	//!	Deleted
+	//!	Node deleted
 	sigc::signal<void> signal_deleted_;
 
 	/*
@@ -204,10 +215,10 @@ public:
 
 	void changed();
 
-	//! Gets the GUID for this value node
+	//! Gets the GUID for this Node
 	const GUID& get_guid()const;
 
-	//! Sets the GUID for this value node
+	//! Sets the GUID for this Node
 	void set_guid(const GUID& x);
 
 	//! Gets the time when the Node was changed
@@ -216,7 +227,7 @@ public:
 	//! Adds the parameter \x as the child of the current Node
 	void add_child(Node*x);
 
-	//! Remove the parameter \x as a child of the current Node
+	//! Removes the parameter \x as a child of the current Node
 	void remove_child(Node*x);
 
 	//!Returns how many parenst has the current Node
@@ -237,17 +248,26 @@ protected:
 	*/
 
 protected:
+	//! Used when the node has changed. Makes changed the parent too.
+	//! To be overloaded by the derivative classes. Emits a signal where the
+	//! the GUI can be connected to.
 	virtual void on_changed();
 
+	//! Used when the node's GUID has changed.
+	//! To be overloaded by the derivative classes. Emits a signal where the
+	//! the GUI can be connected to.
 	virtual void on_guid_changed(GUID guid);
 
-	/*!	Function to be overloaded that fills
-	*/
+	//!	Function to be overloaded that fills the Time Point Set with
+	//! all the children Time Points.
 	virtual void get_times_vfunc(time_set &set) const = 0;
 }; // End of Node class
 
+//! Finds a node by its GUID.
+//! \see global_node_map()
 synfig::Node* find_node(const synfig::GUID& guid);
 
+//! Returns a Handle to the Node by its GUID
 template<typename T> etl::handle<T>
 guid_cast(const synfig::GUID& guid)
 {
-- 
2.7.4