Se agrega un poco mas de documentacion como para cerrar el manual de desarrollo.

diff --git a/Server/include/plaqui/server/server.h b/Server/include/plaqui/server/server.h
index cae6f7cc7eb2de37bf2cc567dfa93d78f4d15e0a..f0f1644b9e7de0c991cfa7631dd7cfbc90dffb3e 100644 (file)
--- a/Server/include/plaqui/server/server.h
+++ b/Server/include/plaqui/server/server.h
@@ -44,7 +44,18 @@ namespace Server {
 
        /**
         * Servidor de plantas químicas.
-        * Maneja múltiples conexiones, de control o de transmisión.
+        *
+        * Esta clase se encarga, entre otras cosas, de definir el método
+        * new_connection() de TCPServer para crear una nueva
+        * \ref ControlServer "conexión de control" para atender las conexiones que
+        * éste recibe.
+        *
+        * Una vez recibida una conexión, esta clase se encarga de manejar los
+        * comandos que a través de ella se reciben a través de los métodos como
+        * cmd_server_info(), cmd_connection_list(), etc.
+        *
+        * Esta clase es también la encargado de mantener la \ref plants "lista" de
+        * \ref Plant "plantas" que se están sirviendo (y simulando).
         */
        class Server: public TCPServer {
 

diff --git a/Server/include/plaqui/server/tcpserver.h b/Server/include/plaqui/server/tcpserver.h
index 5277f2bf188d2b9fb4c867495c518bfcf7c743ab..368594e6b41e394cd2f521a61d65761954410da8 100644 (file)
--- a/Server/include/plaqui/server/tcpserver.h
+++ b/Server/include/plaqui/server/tcpserver.h
@@ -40,8 +40,25 @@ namespace PlaQui {
 namespace Server {
 
        /**
-        * Servidor de plantas químicas.
-        * Maneja muchas conexiones, de control o de transmisión.
+        * Servidor genéríco TCP/IP.
+        *
+        * Maneja muchas conexiones, en threads. En términos generales todo lo que
+        * hace es algo parecido a esto:
+        * \code
+        * while (!stop) {
+        *     Connection* conexion = new_connection(accept());
+        *     connections.push_back(conexion);
+        * }
+        * \endcode
+        *
+        * new_connection() es un método virtual puro que hay que definir en las
+        * subclases para hacer un servidor específico que trabaje con un protocolo
+        * determinado. new_connection() devuelve un puntero a una
+        * \ref Connection "conexión".
+        *
+        * on_connection_finished() maneja la
+        * \ref Runnable::signal_finished "señal para indicar que una conexión terminó"
+        * para eliminarla de la \ref connections "lista de conexiones".
         */
        class TCPServer: public Runnable {