Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Define XBT_ATTRIB_DEPRECATED_v325.
[simgrid.git] / docs / source / application.rst
index af906b4..c3acda1 100644 (file)
@@ -21,9 +21,9 @@ application using one of the following interfaces. It is even possible
 to mix several interfaces in the same simulation.
 
  - :ref:`Describing Algorithms with the S4U interface <S4U_doc>` (in C++)
- - Simulating existing MPI program with the SMPI toolsuite (in C, C++
-   or Fortran)
- - In some cases, you want to replay a trace in the simulator. This
+ - :ref:`Simulating existing MPI programs with the SMPI toolsuite <SMPI_doc>`
+   (in C, C++, or Fortran)
+ - In some cases, you may want to replay an execution trace in the simulator. This
    trace lists the events of your application or of your workload, and
    your application is decomposed as a list of event handlers that are
    fired according to the trace. SimGrid comes with a build-in support
@@ -31,11 +31,16 @@ to mix several interfaces in the same simulation.
    MPI profilers). You can reuse this mecanism for any kind of trace
    that you want to replay, for example to study how a P2P DHT overlay
    reacts to a given workload.
- - Simulating algorithms with one of the legacy interfaces: MSG and
-   SimDAG (in C or Java). SimGrid was founded in 1998, and many
-   interfaces were proposed along the way. MSG, introduced around
-   2002, is still present in SimGrid. It does not evolve anymore, but
-   given its popularity, it will not be removed until at least 2020.
+ - Simulating algorithms with one of the legacy interfaces: :ref:`MSG
+   for distributed algorithms <MSG_doc>` (in :ref:`C <MSG_doc>` or
+   :ref:`Java <Java_doc>`) and SimDAG for
+   centralized algorithms (in C). SimGrid was founded in 1998, and
+   many interfaces were proposed along the way. MSG (introduced
+   around 2002) and SimDag (introduced before 2000), are still present
+   in SimGrid. They do not evolve anymore, but given their popularity,
+   they will not be removed until at least 2020. That being said, our
+   goal is to make S4U so useful that these legacy APIs become useless
+   and obsolete.
  - We are currently working on the ability to modify any existing
    application so that it can run on top of SimGrid. This project,
    called `Remote-SimGrid
@@ -49,21 +54,11 @@ users can invent the specific API or DSL they need for their usage. We
 call this project BYOS: Build Your Own Simulator.
 
 Executing existing applications within the simulator is another
-long-term goal. SMPI and Remote-SimGrid already allow to execute some
-applications, but our long term goal would be to allow the execution
+long-term goal. SMPI and Remote-SimGrid already allow you to execute some
+applications, but our long term goal would be to allow for the execution
 of any legacy application, with absolutely no modification. We call it
 SimOS, even if it will not become usable before several years of
 additional work.
 
 .. The old documentation of the obsolete MSG replay module was removed in
 ..  https://github.com/simgrid/simgrid/commit/e05361c201fb95d2b7605e59001cd0a49a489739
-
-
-.. include:: app_smpi.rst
-
-.. include:: app_legacy.rst
-
-.. toctree::
-   :hidden:
-
-      The S4U Interface <app_s4u.rst>