Another example gets documented (+cosmetics)

diff --git a/docs/source/Models.rst b/docs/source/Models.rst
index d53b16e..ac3f058 100644 (file)
--- a/docs/source/Models.rst
+++ b/docs/source/Models.rst
@@ -202,6 +202,8 @@ seconds but
 For more details, please refer to "Accuracy study and improvement of network simulation in the SimGrid framework" by
 Arnaud Legrand and Pedro Velho.
 
+.. _models_l07:
+
 Parallel tasks (L07)
 ********************
 
@@ -210,6 +212,8 @@ This is because this model is intended to be used for parallel tasks that are ac
 Max-Min objective function requires that all variables are expressed using the same unit. This is also why in reality,
 we have one LMM system per resource kind in the simulation, but the idea remains similar.
 
+Use the :ref:`relevant configuration <options_model_select>` to select this model in your simulation.
+
 .. _models_wifi:
 
 WiFi zones

diff --git a/examples/README.rst b/examples/README.rst
index c7a55a2..cc35595 100644 (file)
--- a/examples/README.rst
+++ b/examples/README.rst
@@ -678,6 +678,15 @@ This example illustrates how to simply read and write data on a simulated disk r
 
       This shows how to declare disks in XML.
 
+Asynchronous raw accesses
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+As most other activities, raw IO accesses can be used asynchronously, as illustrated in this example.
+
+.. tabs::
+
+   .. example-tab:: examples/cpp/io-async/s4u-io-async.cpp
+
 Filesystem plugin
 ^^^^^^^^^^^^^^^^^
 

diff --git a/include/simgrid/s4u/Actor.hpp b/include/simgrid/s4u/Actor.hpp
index de7a22e..acdcafe 100644 (file)
--- a/include/simgrid/s4u/Actor.hpp
+++ b/include/simgrid/s4u/Actor.hpp
@@ -101,16 +101,16 @@ XBT_PUBLIC void execute(double flop, double priority);
  *
  * These objects are somewhat surprising from a modeling point of view. For example, the unit of their speed is
  * somewhere between flop/sec and byte/sec. Arbitrary parallel executions will simply not work with the usual platform
- * models, and you must :ref:`use the ptask_L07 host model <options_model_select>` for that. Note that you can mix
+ * models, and you must :ref:`use the ptask_L07 host model <models_l07>` for that. Note that you can mix
  * regular executions and communications with parallel executions, provided that the host model is ptask_L07.
  *
  * @endrst
  */
-/** Block the current actor until the built parallel execution completes */
+/** Block the current actor until the built parallel execution completes. */
 XBT_PUBLIC void parallel_execute(const std::vector<s4u::Host*>& hosts, const std::vector<double>& flops_amounts,
                                  const std::vector<double>& bytes_amounts);
 
-/** Block the current actor until the built multi-thread execution completes */
+/** Block the current actor until the built multi-thread execution completes. */
 XBT_PUBLIC void thread_execute(s4u::Host* host, double flop_amounts, int thread_count);
 
 /** Initialize a sequential execution that must then be started manually */