From c0c615a959dc4f317aa7def359335bd3b8cf7930 Mon Sep 17 00:00:00 2001
From: Ricardo Markiewicz <gazer.arg@gmail.com>
Date: Fri, 7 Nov 2003 23:28:49 +0000
Subject: [PATCH 1/1] =?utf8?q?*=20Se=20comenta=20un=20poco=20m=C3=A1s=20el?=
 =?utf8?q?=20modelo.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

---
 Model/include/drain.h     |  1 +
 Model/include/iconector.h |  5 +++++
 Model/include/splitter.h  |  6 ++++++
 Model/include/tank.h      | 19 +++++++++++++++----
 Model/include/union.h     | 11 ++++++++++-
 5 files changed, 37 insertions(+), 5 deletions(-)

diff --git a/Model/include/drain.h b/Model/include/drain.h
index 25f75d8..df27e8f 100644
--- a/Model/include/drain.h
+++ b/Model/include/drain.h
@@ -35,5 +35,6 @@ private:
 
 }
 }
+
 #endif // _H_SOURCE_H_
 
diff --git a/Model/include/iconector.h b/Model/include/iconector.h
index 916d341..f3f6760 100644
--- a/Model/include/iconector.h
+++ b/Model/include/iconector.h
@@ -9,6 +9,11 @@ namespace PlaQui {
 
 namespace Model {
 /** Conector genérico de elementos
+ *
+ *  El conector es un interfaz común que permite a objetos de distinto
+ *  tipo comunicarse entre sí sin la necesidad de conocerse.
+ *  Maneja una lista de elementos conectados a uno, que pueden estar
+ *  tanto conectados a una entrada como a una salida.
  */
 class IConector {
 public:
diff --git a/Model/include/splitter.h b/Model/include/splitter.h
index 7adbb49..a76c117 100644
--- a/Model/include/splitter.h
+++ b/Model/include/splitter.h
@@ -8,9 +8,15 @@ namespace PlaQui {
 
 namespace Model {
 
+/** Divisor de Flujo
+ *
+ *  Divide el flujo entrante en 2 partes iguales que envía a sus salidas
+ */
 class Splitter:public Transport {
 public:
+	/// Constructor
 	Splitter(const std::string &_name);
+	/// Destructor
 	virtual ~Splitter();
 
 	virtual void recieve_msg(int msg, IConector *who, void *data);
diff --git a/Model/include/tank.h b/Model/include/tank.h
index d4173af..dbb56c4 100644
--- a/Model/include/tank.h
+++ b/Model/include/tank.h
@@ -9,10 +9,20 @@
 namespace PlaQui {
 	
 namespace Model {
-				
+
+/** Tanque de Agua/Líquido
+ *
+ *  Se modela un tanque con una entrada y una salida. La cantidad máxima
+ *  de flujo entrante estará dada por la diferencia entre la capacidad
+ *  y la cantidad actual de líquido en el tanque.
+ *  La cantidad máxima de flujo que puede ofrecer a la salida está dada
+ *  por la cantidad de líquido en el tanque.
+ */ 
 class Tank:public Source, public Drain {
 public:
+	/// Constructor
 	Tank(const std::string &_name);
+	/// Destructor
 	virtual ~Tank();
 
 	virtual bool get_output();
@@ -21,9 +31,9 @@ public:
 	virtual void update();
 	virtual void simulate();
 protected:
-	float litros;	
-	float actual_in_flow;
-	float actual_out_flow;
+	float litros;	///< cantidad de líquido actual
+	float actual_in_flow; ///< flujo máximo a la entrada
+	float actual_out_flow; ///< flujo máximo de la salida
 private:
 	Tank():Drain("null"),Source("null"),Control("null") {}
 	Tank &operator = (const Tank &) { return *this; } 
@@ -33,3 +43,4 @@ private:
 }
 
 #endif // _TANK_H_
+
diff --git a/Model/include/union.h b/Model/include/union.h
index b08bc23..0f494a2 100644
--- a/Model/include/union.h
+++ b/Model/include/union.h
@@ -8,16 +8,25 @@ namespace PlaQui {
 
 namespace Model {
 
+/** Convina 2 flujos entrantes
+ *
+ *  Este objeto tiene 2 entradas y una salida. El flujo entrante por cada salida
+ *  se convina y se manda por la salida, aplicando la correcta suma de los colores.
+ *
+ *  TODO : Hacer que anda bien
+ */
 class Union:public Transport {
 public:
+	/// Constructor
 	Union(const std::string &_name);
+	/// Destructor
 	virtual ~Union();
 
 	virtual void recieve_msg(int msg, IConector *who, void *data);
 	virtual void update(int dir=OUT);
 	virtual void simulate();
 protected:
-	int in_on_zero;
+	int in_on_zero; 
 	int in_ready;
 private:
 	Union(const Union &):Transport("null") {}
-- 
2.43.0