X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/3251d90fe4b97b5021ded47d783262266d7df9f5..dbeadedd0671b3632be1b6bf4791837569d5e33f:/doc/install.doc
diff --git a/doc/install.doc b/doc/install.doc
index e9426bedb3..b97eab3995 100644
--- a/doc/install.doc
+++ b/doc/install.doc
@@ -60,12 +60,30 @@ $ java -cp .:../simgrid.jar basic/BasicTest platform.xml basic/basicDeployment.x
\section bindings_binding_java_coroutines How to use the coroutines context factory
-First, remember that the coroutines context factory is still experimental work.
+You may want to use the coroutines context factory, if speed maters to
+you (since it's about 5 times faster than the default thread-based
+context factory).
-To use the coroutines context factory, you need a Java virtual machine which supports it.
+First, remember that the coroutines context factory is still
+experimental work.
-Our implementation rely on a JVM patch made by Lukas Stadler, which you can find here.
+To use the coroutines context factory, you need a Java virtual machine
+which supports it.
+Our implementation rely on a JVM patch made by Lukas Stadler, which
+you can find here. You
+can either recompile the JVM yourself or use the offered pre-built
+binaries.
-
+SimGrid Java will automatically switch to the coroutine context
+factory if your JVM support it, so you will just need to execute your
+simulation with the correct JVM:
+\verbatim
+$ $PATH_TO_COROUTINE_JVM/java -cp .:../simgrid.jar basic/BasicTest platform.xml basic/basicDeployment.xml
+\endverbatim
+
+Note that you may have to adjust the "coro.stacksPerThread" configuration option to run large simulations:
+\verbatim
+$ $PATH_TO_COROUTINE_JVM/java -Dcoro.stacksPerThread=$STACKS_NUMBER -cp .:../simgrid.jar basic/BasicTest platform.xml basic/basicDeployment.xml
+\endverbatim
*/