X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/12db95ab94e1021a75da2fb043d341a8b90aa72c..893d3998bdac575d97dae0c817412296a26ab6f9:/doc/modules.doc

diff --git a/doc/modules.doc b/doc/modules.doc
index ae955eb0d6..7794d32527 100644
--- a/doc/modules.doc
+++ b/doc/modules.doc
@@ -2,9 +2,10 @@
   \defgroup SimGrid_API  SimGrid modules */
 
 /** \defgroup XBT_API      XBT
-       \ingroup SimGrid_API
-       \brief The core toolbox of SimGrid, containing usefull datatypes,
-       portability support and so on.
+    \ingroup SimGrid_API
+    \brief The core toolbox of SimGrid, containing usefull datatypes,
+           portability support and so on.
+
 */
 
 /** \defgroup SURF_API       SURF
@@ -15,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
@@ -35,10 +35,12 @@
 
       \section MSG_who Who should use this (and who shouldn't)
       
-      You should use this model 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,
+      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 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
@@ -67,7 +69,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
@@ -103,9 +105,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).
+
+*/