X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/0f3240d4613e89aaabdc84c9c0b1531c93bd31c2..41310a373e5ada253ade83ba72ebe11d8995851e:/doc/modules.doc

diff --git a/doc/modules.doc b/doc/modules.doc
index fede18e5ce..f8c8ebf9d6 100644
--- a/doc/modules.doc
+++ b/doc/modules.doc
@@ -6,7 +6,6 @@
     \brief The core toolbox of SimGrid, containing usefull datatypes,
            portability support and so on.
 
-   
 */
 
 /** \defgroup SURF_API       SURF
@@ -17,8 +16,7 @@
       platform. It is very low-level and is not intended to be used as
       such but rather to serve as a basis for higher-level simulators.
       We're still working on it and the structure is a little bit
-      complex. So we'll document it only when we'll be completely satisfied of 
-      the way it is organized.
+      complex.
 
       It is where platform models are encoded. If you need a model that is not 
       encoded yet, please tell me (<arnaud.legrand@imag.fr>) and we'll
@@ -38,15 +36,18 @@
       \section MSG_who Who should use this (and who shouldn't)
       
       You should use this module if you want to study some heuristics for a
-      given problem you don't really want to implement. If you want to get a
-      real implementation of your solution, have a look at the \ref GRAS_API 
-      programming environment. If you want to study an existing MPI program,
+      given problem you don't really want to implement.
+      If you want to use DAGs, have a look at the \ref SD_API programming
+      environment.
+      If you want to get a real implementation of your solution, have a look
+      at the \ref GRAS_API one. If you want to study an existing MPI program,
       have a look at the \ref SMPI_API one. If none of those programming
       environments fits your needs, you may consider implementing your own 
       directly on top of \ref SURF_API (but you probably want to contact us
       before). 
 */
 
+
 /** \defgroup GRAS_API      GRAS
     \ingroup SimGrid_API
     \brief Realistic programming environment (Grid Reality And Simulation)
@@ -69,7 +70,7 @@
     may eventually be distributed. 
     If you just want to study some heuristics for a given problem you don't
     want to implement really (ie, if your result would be a theorem), have a
-    look at the \ref MSG_API one.
+    look at the \ref MSG_API one, or the \ref SD_API one if you need to use DAGs.
     If you want to study an existing MPI program, have a look at the 
     \ref SMPI_API one. 
     If none of those programming environments fits your needs, you may
@@ -105,9 +106,37 @@
     \ref GRAS_API environment. 
     If you want to study some heuristics for a given problem (and if your
     goal is to produce theorems, not code), have a look at the \ref MSG_API
-    environment.
+    environment, or the \ref SD_API one if you need to use DAGs.
     If none of those programming environments fits your needs, you may
     consider implementing your own directly on top of \ref SURF_API (but you
     probably want to contact us before).
   
  */
+
+
+/** \defgroup SD_API      SimDag
+    \ingroup SimGrid_API
+    \brief Programming environment for DAG applications
+   
+    SimDag provides some functionnalities to simulate parallel task scheduling
+    with DAGs models (Direct Acyclic Graphs).
+    The old versions of SimGrid were based on DAGs. But the DAG part (named SG)
+    was removed in SimGrid 3 because the new kernel (\ref SURF_API) was implemented. \ref SURF_API
+    was much faster and more flexible than SG and did not use DAGs.
+    SimDag is a new implementation of DAGs handling and it is built on top of \ref SURF_API.
+    
+    \section SD_who Who should use this (and who shouldn't)
+    
+    You should use this programming environment of the SimGrid suite if you want
+    to study algorithms and heuristics with DAGs of parallel tasks.
+    If you don't need to use DAGs for your simulation, have a look at the
+    \ref MSG_API programming environment.
+    If you want to implement a real distributed application, have a look at the
+    \ref GRAS_API programming environment.
+    If you want to study an existing MPI program, have a look at the 
+    \ref SMPI_API one. 
+    If none of those programming environments fits your needs, you may
+    consider implementing your own directly on top of \ref SURF_API (but you
+    probably want to contact us before).
+
+*/