+@endverbatim
+
+@section pls_ns3_use Using ns-3 from SimGrid
+
+The SimGrid-ns3 binding only contains features that are common to both
+systems: ns-3 wireless models are not available, while SimGrid routes
+cannot be longer than 1. Also, the platform built in ns-3 from the
+SimGrid description is very basic.
+
+Any route longer than one will be ignored when using ns-3. They are
+harmless, but you still need to connect your hosts using one-hop routes.
+The best solution is to add routers to split your route. Here is an
+example of invalid platform:
+
+@code{.xml}
+<platform>
+ <host id="alice" speed="1Gf" />
+ <host id="bob" speed="1Gf" />
+
+ <link id="l1" bw="1Mbps" />
+ <link id="l2" bw="1Mbps" />
+
+ <route src="alice" dst="bob">
+ <link_ctn id="l1"/> <!-- INVALID WITH NS-3 -->
+ <link_ctn id="l2"/> <!-- length=2 IS TOO MUCH -->
+ </route>
+</platform>
+@endcode
+
+Here is the same platform expressed in a way that ns-3 will understand.
+There is no direct connexion from alice to bob, but that's OK because
+ns-3 will find the path from point to point.
+
+@code{.xml}
+<platform>
+ <host id="alice" speed="1Gf" />
+ <host id="bob" speed="1Gf" />
+
+ <router id="r1" /> <!-- routers are compute-less hosts -->
+
+ <link id="l1" bw="1Mbps" />
+ <link id="l2" bw="1Mbps" />
+
+ <route src="alice" dst="r1">
+ <link_ctn id="l1"/>
+ </route>
+
+ <route src="r1" dst="bob">
+ <link_ctn id="l2"/>
+ </route>
+</platform>
+@endcode
+
+
+Once your platform is OK, just change the "network/model"
+configuration option to "NS3" as follows. The rest remains unchanged.
+
+@verbatim
+./network-ns3 ../../platforms/small_platform_one_link_routes.xml 3hosts_2links_d.xml --cfg=network/model:NS3
+@endverbatim
+
+Many other files from the examples/platform directory are usable with
+the ns-3 model, such as @ref examples/platforms/dogbone.xml. Check the file
+examples/deprecated/msg/network-ns3/network-ns3.tesh to see which ones are used
+in our regression tests. You may also be interested in the
+@ref msg_ex_ns3 "ns-3/SimGrid examples".
+
+@subsection pls_ns3_shortcomings Shortcomings of the ns-3 bindings in SimGrid
+
+A ns-3 platform is automatically created from the provided SimGrid
+platform. However, there are some known caveats:
+
+<ul>
+
+ <li>The default values (e.g., TCP parameters) are the ns3 default
+ values.</li>