Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
fix some TOC of doc, detected by automatic tests
[simgrid.git] / doc / FAQ.doc
index 6e5182f..552655c 100644 (file)
@@ -72,29 +72,7 @@ filter (e.g. with bash):
 ./msg_test small_platform.xml small_deployment.xml 2>&1 | ../../tools/MSG_visualization/colorize.pl
 \endverbatim
 
-We also have a more graphical output. Have a look at MSG_paje_output(). It 
-generates an input to <a href="http://www-id.imag.fr/Logiciels/paje/">Paje</a>.
-<center>
-\htmlonly
- <a href="Paje_MSG_screenshot.jpg"><img src="Paje_MSG_screenshot_thn.jpg"></a>
-\endhtmlonly
-</center>
-
-Visualization with Paje can be seen as a kind of postmortem
-analysis. However, as soon as you start playing with big simulations,
-you'll realize that processing such output is kind of tricky. There is
-so much generic information that it is hard to find the information
-you are looking for.
-
-As a matter of fact, logging really depends on simulations (e.g. what
-kind of events is important...). That is why we do not propose a big
-dump of your whole simulation (it would slow everything down) but give
-you neat tools to structure you logs. Have a look at \ref XBT_log. In
-fact, rather than a post-mortem analysis, you may want to do it on the
-fly. The process you are running can do whatever you want. Have you
-thought about adding a global structure where you directly compute the
-information that are really important rather than writing everything
-down and then processing huge files?
+We also have a more graphical output. Have a look at section \ref faq_tracing.
 
 \subsection faq_C Argh! Do I really have to code in C?
 
@@ -386,10 +364,26 @@ CMake needs some prerequists like :
   \li ccmake for graphical used of CMake
   \li cmake <a href="http://www.cmake.org/cmake/resources/software.html">(download page)</a>
 
-\subsubsection faq_intro4 Cmake vs Autotools...
-
-TODO
-
+For windows only : 
+  \li Visual C++ 2010 Express <a href="http://www.microsoft.com/express/Downloads/#2010-Visual-CPP">(download page)</a>
+  \li cmake <a href="http://www.cmake.org/cmake/resources/software.html">(download page)</a>
+  \li Set CC, CXX, INCLUDE, LIB and RC to environment variables.
+\verbatim
+SET --> CC     TO --> C:\MicrosoftVisualStudio10\VC\bin\cl
+    --> CXX       --> C:\MicrosoftVisualStudio10\VC\bin\cl
+    --> INCLUDE           --> C:\MicrosoftVisualStudio10\VC\include;C:\Program Files\Microsoft SDKs\Windows\v7.OA\Include
+    --> LIB       --> C:\MicrosoftVisualStudio10\VC\lib;C:\Program Files\Microsoft SDKs\Windows\v7.OA\Lib
+    --> RC        --> C:\Program Files\Microsoft SDKs\Windows\v7.OA\bin\RC
+\endverbatim
+  \li Add to environment variable "Path" the path where to find nmake executable and some needed files.
+\verbatim
+......
+;C\MicrosoftVisualStudio10\VC\bin
+;C\MicrosoftVisualStudio10\Common7\IDE
+;C:\Program Files\Microsoft SDKs\Windows\v7.OA\bin
+;C:\Program Files\Microsoft SDKs\Windows\v7.OA\Lib
+;C:\Program Files\Microsoft SDKs\Windows\v7.OA\bInclude
+\endverbatim  
 \subsection faq_cmakeoption Cmake options
 
 \subsubsection faq_cmakeoption1 Liste of options
@@ -403,12 +397,13 @@ TODO
                enable_ruby                             ON/OFF or TRUE/FALSE or 1/0
                enable_compile_optimizations            ON/OFF or TRUE/FALSE or 1/0
                enable_compile_warnings                 ON/OFF or TRUE/FALSE or 1/0
+               enable_smpi                             ON/OFF or TRUE/FALSE or 1/0
                enable_maintainer_mode                  ON/OFF or TRUE/FALSE or 1/0
                enable_supernovae                       ON/OFF or TRUE/FALSE or 1/0
                enable_tracing                          ON/OFF or TRUE/FALSE or 1/0
                enable_coverage                         ON/OFF or TRUE/FALSE or 1/0
                enable_memcheck                         ON/OFF or TRUE/FALSE or 1/0 
-               enable_print_message                    ON/OFF or TRUE/FALSE or 1/0
+               enable_model-checking                   ON/OFF or TRUE/FALSE or 1/0
 
                gtnets_path                             <path_to_gtnets_directory>
                prefix                                  <path_to_install_directory>
@@ -430,6 +425,8 @@ TODO
 
   \li enable_compile_warnings : add flags "-Wall -Wunused -Wmissing-prototypes -Wmissing-declarations -Wpointer-arith -Wchar-subscripts -Wcomment -Wformat -Wwrite-strings -Wno-unused-function -Wno-unused-parameter -Wno-strict-aliasing -Wno-format-nonliteral -Werror"
 
+  \li enable_smpi : Set to true if you want to use smpi lib. Actually on simgrid v3.4.1 Mac doesn't support lib smpi.
+
   \li enable_maintainer_mode : set to true it remakes some files.
 \verbatim
 include/surf/simgrid_dtd.h
@@ -473,7 +470,7 @@ src/gras/DataDesc/ddt_parse.yy.c
 
   \li enable_memcheck : When set to true this option enable tests for memcheck.
 
-  \li enable_print_message : This option when enable permits to see variables from gras_config.h
+  \li enable_model-checking : Enable the model checking when set to true.
 
   \li gtnets_path : Path to gtnets install directory (ex /usr)
 
@@ -485,7 +482,7 @@ src/gras/DataDesc/ddt_parse.yy.c
 
 \subsubsection faq_cmakeoption3 Initialisation
 
-Those options are initialized the first time you launch \"cmake ./\" whithout specified option.
+Those options are initialized the first time you launch "cmake ." whithout specified option.
 
 \verbatim
 enable_gtnets                  on
@@ -494,12 +491,13 @@ enable_ruby                       on
 enable_java                    off
 enable_compile_optimizations   off
 enable_compile_warnings                off
+enable_smpi                    on
 enable_maintainer_mode         off
 enable_supernovae              off
 enable_tracing                 off
 enable_coverage                off
 enable_memcheck                off
-enable_print_message           off
+enable_model-checking          off
 
 gtnets_path                    null
 prefix                         null
@@ -509,7 +507,7 @@ with_context                        auto
 
 \subsubsection faq_cmakeoption4 Option's cache and how to reset?
 
-When options have been set they are keep into a cache file named \"CMakeCache.txt\". So if you want 
+When options have been set they are keep into a cache file named "CMakeCache.txt". So if you want 
 reset values you just delete this file located to the project directory.
 
 \subsection faq_cmakecompilation Cmake compilation
@@ -528,17 +526,41 @@ make
 \endverbatim
 Then follow instructions.
 
+\subsubsection faq_cmakecompilation2bis Build out of source.
+
+As cmake generate many files used for compilation, we recommand to make a build directory.
+For examples you can make :
+
+\verbatim
+"navarrop@caraja:~/Developments$ cd simgrid/"
+"navarrop@caraja:~/Developments/simgrid$ mkdir build_directory"
+"navarrop@caraja:~/Developments/simgrid$ cd build_directory/"
+"navarrop@caraja:~/Developments/simgrid/build_directory$ cmake ../"
+"navarrop@caraja:~/Developments/simgrid/build_directory$ make"
+\endverbatim
+
+Or complety out of sources :
+
+\verbatim
+"navarrop@caraja:~/Developments$ mkdir build_dir"
+"navarrop@caraja:~/Developments$ cd build_dir/"
+"navarrop@caraja:~/Developments/build_dir$ cmake ../simgrid/"
+"navarrop@caraja:~/Developments/build_dir$ make"
+\endverbatim
+
+Those two kind of compilation permit to delete files created by compilation easier.
+
 \subsubsection faq_cmakecompilation3 Resume of command line
 
  \li CMake
 \verbatim
-cmake ./               configure the project
+cmake <path>           configure the project
 make                   build all targets
 make VERBOSE=1         build all targets and print build command lines
-make test              test all targets and summarize
+make check             test all targets and summarize
 make dist              make the distrib
-make distcheck         check the dist (make + make dist + make test
-make install-simgrid   install the project (doc/ lib/ include/)
+make distcheck         check the dist (make + make dist + make check
+make install           install the project (doc/ lib/ include/)
 make uninstall         uninstall the project (doc/ lib/ include/)
 make clean             clean all targets
 make java-clean                clean files created by java option
@@ -547,7 +569,6 @@ make supernovae-clean       clean supernovae files
 make maintainer-clean  clean maintainer files
 make all-clean         execute the 5 upper clean command
 make html              Create simgrid documentation
-make maintainer-clean   Remove all files generated by mainainer mode
 \endverbatim
 
 When the project have been succesfully compiling and build you can make tests.
@@ -574,142 +595,144 @@ If you want to test before make a commit you can simply make "ctest -D Experimen
 \li Mode maintainer
 
 cmake -Denable_maintainer_mode=on ./
-\verbatim GTnetS doesn't works : set -Ddisable_gtnets=on
+\verbatim 
+-- lookign for config.h
 with_context auto change to ucontext
-(skaddr)
-(sksize)
-Make : src/simgrid.jar with : /usr/bin/javac
-Make examples/java with : /usr/bin/javac
+GIT_DATE       : 2010-05-04~09-59-15
+GIT_VERSION    : 53ec816
+GIT_SVN_VERSION : 7669
 
-Configuration of package `simgrid' (revision 7228M) on arch (=4):
-       BUILDNAME :             UCONTEXT
-            SITE :             Linux_Ubuntu 9.10_x86_64
+Configuration of package `simgrid' (revision 7669) on arch (=4):
+            BUILDNAME :        UCONTEXT
+            SITE      :        Linux_2.6.31-21-generic_x86_64
+            Release   :        simgrid-3.4~rev7669
 
-       Compiler: c++ :         /usr/bin/c++
-              version:         c++ (Ubuntu 4.4.1-4ubuntu9) 4.4.1
-                 c   :         /usr/bin/gcc
-              version:         gcc (Ubuntu 4.4.1-4ubuntu9) 4.4.1
+        Compiler: c++ :        /usr/bin/c++
+               version:        c++ (Ubuntu 4.4.1-4ubuntu9) 4.4.1
+        Compiler: c   :        /usr/bin/gcc
+               version:        gcc (Ubuntu 4.4.1-4ubuntu9) 4.4.1
 
-       CFlags:                 -g3
-       CPPFlags:               
-       LDFlags:                
+              CFlags  :        -I/usr/lib/ruby/1.8/x86_64-linux -I/usr/include/lua5.1 -g3
+              CPPFlags:        
+              LDFlags :        -L/usr/lib/
 
        Context backend:        ucontext
-       Compile Gtnets:         0
-                 path:         
-       Compile Java:           1
-       Compile Lua:            1
-       Compile Ruby:           0
-
-       Maintainer mode:        on
-       Supernovae mode:        off
+       Compile Gtnets :        0
+       Gtnets path    :        
+       Compile Java   :        0
+       Compile Lua    :        1
+       Compile Ruby   :        1
+
+       Compile Smpi   :        ON
+       Maintainer mode:        ON
+       Supernovae mode:        OFF
+       Tracing mode   :        OFF
 
-       Simgrid dependencies:   dl -llua5.1
-       Gras dependencies:      pthread
-       Ruby dependencies:      
-       Smpi dependencies:      
+       Simgrid dependencies:   -lm -lruby1.8 -module -ldl -llua5.1 -lrt
+       Gras dependencies   :   -lm -lpthread -lrt
+       Smpi dependencies   :   
 
-       USER_PREFIX:            /usr/local
        INSTALL_PREFIX:         /usr/local
 
 -- Configuring done
 -- Generating done
--- Build files have been written to: /home/navarrop/Bureau/simgrid-trunk
+-- Build files have been written to: /home/navarrop/Developments/simgrid
 \endverbatim
 
 \li Mode supernovae
 
 cmake -Dsupernovae=on ./
-\verbatim GTnetS doesn't works : set -Ddisable_gtnets=on
+\verbatim 
+-- lookign for config.h
 with_context auto change to ucontext
-(skaddr)
-(sksize)
-Make : src/simgrid.jar with : /usr/bin/javac
-Make examples/java with : /usr/bin/javac
+GIT_DATE       : 2010-05-04~09-59-15
+GIT_VERSION    : 53ec816
+GIT_SVN_VERSION : 7669
 
-Configuration of package `simgrid' (revision 7228M) on arch (=4):
-       BUILDNAME :             SUPERNOVAE
-            SITE :             Linux_Ubuntu 9.10_x86_64
+Configuration of package `simgrid' (revision 7669) on arch (=4):
+            BUILDNAME :        SUPERNOVAE
+            SITE      :        Linux_2.6.31-21-generic_x86_64
+            Release   :        simgrid-3.4~rev7669
 
-       Compiler: c++ :         /usr/bin/c++
-              version:         c++ (Ubuntu 4.4.1-4ubuntu9) 4.4.1
-                 c   :         /usr/bin/gcc
-              version:         gcc (Ubuntu 4.4.1-4ubuntu9) 4.4.1
+        Compiler: c++ :        /usr/bin/c++
+               version:        c++ (Ubuntu 4.4.1-4ubuntu9) 4.4.1
+        Compiler: c   :        /usr/bin/gcc
+               version:        gcc (Ubuntu 4.4.1-4ubuntu9) 4.4.1
 
-       CFlags:                 -O3 -finline-functions -funroll-loops -fno-strict-aliasing -Wall -Wunused -Wmissing-prototypes -Wmissing-declarations -Wpointer-arith -Wchar-subscripts -Wcomment -Wformat -Wwrite-strings -Wno-unused-function -Wno-unused-parameter -Wno-strict-aliasing -Wno-format-nonliteral -Werror -g3
-       CPPFlags:               
-       LDFlags:                
+              CFlags  :        -O3 -finline-functions -funroll-loops -fno-strict-aliasing -Wall -Wunused -Wmissing-prototypes -Wmissing-declarations -Wpointer-arith -Wchar-subscripts -Wcomment -Wformat -Wwrite-strings -Wno-unused-function -Wno-unused-parameter -Wno-strict-aliasing -Wno-format-nonliteral -Werror -I/usr/lib/ruby/1.8/x86_64-linux -I/usr/include/lua5.1 -g3
+              CPPFlags:        
+              LDFlags :        -L/usr/lib/
 
        Context backend:        ucontext
-       Compile Gtnets        0
-                 path:         
-       Compile Java:           1
-       Compile Lua:            1
-       Compile Ruby:           0
+       Compile Gtnets :        0
+       Gtnets path    :        
+       Compile Java   :        0
+       Compile Lua    :        1
+       Compile Ruby   :        1
 
-       Maintainer mode:        off
-       Supernovae mode:        on
+       Compile Smpi   :        ON
+       Maintainer mode:        OFF
+       Supernovae mode:        OFF
+       Tracing mode   :        OFF
 
-       Simgrid dependencies:   dl -llua5.1
-       Gras dependencies:      pthread
-       Ruby dependencies:      
-       Smpi dependencies:      
+       Simgrid dependencies:   -lm -lruby1.8 -module -ldl -llua5.1 -lrt
+       Gras dependencies   :   -lm -lpthread -lrt
+       Smpi dependencies   :   
 
-       USER_PREFIX:            /usr/local
        INSTALL_PREFIX:         /usr/local
 
 -- Configuring done
 -- Generating done
--- Build files have been written to: /home/navarrop/Bureau/simgrid-trunk
+-- Build files have been written to: /home/navarrop/Developments/simgrid
+
 \endverbatim
 
 \li Mode GTnetS
 
 cmake -Dgtnets_path=/home/navarrop/Bureau/usr/ ./
-\verbatim with_context auto change to ucontext
-(skaddr)
-(sksize)
-Make : src/simgrid.jar with : /usr/bin/javac
-Make examples/java with : /usr/bin/javac
+\verbatim 
+-- lookign for config.h
+with_context auto change to ucontext
+GIT_DATE       : 2010-05-04~09-59-15
+GIT_VERSION    : 53ec816
+GIT_SVN_VERSION : 7669
 
-Configuration of package `simgrid' (revision 7228M) on arch (=4):
-       BUILDNAME :             GTNETS
-            SITE :             Linux_Ubuntu 9.10_x86_64
+Configuration of package `simgrid' (revision 7669) on arch (=4):
+            BUILDNAME :        GTNETS
+            SITE      :        Linux_2.6.31-21-generic_x86_64
+            Release   :        simgrid-3.4~rev7669
 
-       Compiler: c++ :         /usr/bin/c++
-              version:         c++ (Ubuntu 4.4.1-4ubuntu9) 4.4.1
-                 c   :         /usr/bin/gcc
-              version:         gcc (Ubuntu 4.4.1-4ubuntu9) 4.4.1
+        Compiler: c++ :        /usr/bin/c++
+               version:        c++ (Ubuntu 4.4.1-4ubuntu9) 4.4.1
+        Compiler: c   :        /usr/bin/gcc
+               version:        gcc (Ubuntu 4.4.1-4ubuntu9) 4.4.1
 
-       CFlags:                  -L/home/navarrop/Bureau/usr/lib -I/home/navarrop/Bureau/usr/include/gtnets -g3
-       CPPFlags:                -L/home/navarrop/Bureau/usr/lib -I/home/navarrop/Bureau/usr/include/gtnets 
-       LDFlags:                
+              CFlags  :        -O3 -finline-functions -funroll-loops -fno-strict-aliasing -Wall -Wunused -Wmissing-prototypes -Wmissing-declarations -Wpointer-arith -Wchar-subscripts -Wcomment -Wformat -Wwrite-strings -Wno-unused-function -Wno-unused-parameter -Wno-strict-aliasing -Wno-format-nonliteral -Werror -I/usr/lib/ruby/1.8/x86_64-linux -L/usr/lib -I/usr/include/gtnets -I/usr/include/lua5.1 -g3
+              CPPFlags:        -L/usr/lib -I/usr/include/gtnets 
+              LDFlags :        -L/usr/lib/
 
        Context backend:        ucontext
-       Compile Gtnets        1
-                 path:         /home/navarrop/Bureau/usr
-       Compile Java:           1
-       Compile Lua:            1
-       Compile Ruby:           0
+       Compile Gtnets :        1
+       Gtnets path    :        /usr
+       Compile Java   :        0
+       Compile Lua    :        1
+       Compile Ruby   :        1
 
-       Maintainer mode:        off
-       Supernovae mode:        off
+       Compile Smpi   :        ON
+       Maintainer mode:        OFF
+       Supernovae mode:        OFF
+       Tracing mode   :        OFF
 
-       Simgrid dependencies:   dl -llua5.1 -lgtnets
-       Gras dependencies:      pthread
-       Ruby dependencies:      
-       Smpi dependencies:      
+       Simgrid dependencies:   -lm -lruby1.8 -module -ldl -llua5.1 -lgtnets -lrt
+       Gras dependencies   :   -lm -lpthread -lrt
+       Smpi dependencies   :   
 
-       USER_PREFIX:            /usr/local
        INSTALL_PREFIX:         /usr/local
 
-INFO -->> Take care to have export LD_LIBRARY_PATH before run make command for make examples with gtnets
-copy and paste : export LD_LIBRARY_PATH=/home/navarrop/Bureau/usr/lib/:$LD_LIBRARY_PATH
-
-
 -- Configuring done
 -- Generating done
--- Build files have been written to: /home/navarrop/Bureau/simgrid-trunk
+-- Build files have been written to: /home/navarrop/Developments/simgrid
+
 \endverbatim
 
 \subsection faq_cmakeinstall How to install with cmake?
@@ -719,7 +742,7 @@ copy and paste : export LD_LIBRARY_PATH=/home/navarrop/Bureau/usr/lib/:$LD_LIBRA
 \verbatim
 cmake -Denable_maintainer_mode=on -Dprefix=/home/navarrop/Bureau/install_simgrid ./
 make 
-make install-simgrid
+make install
 \endverbatim
 
 \subsubsection faq_cmakeinstall2 From a distrib
@@ -727,59 +750,8 @@ make install-simgrid
 \verbatim
 cmake -Dprefix=/home/navarrop/Bureau/install_simgrid ./
 make
-make install-simgrid
-\endverbatim
-
-\subsection faq_screenshot Screenshot
-
-\verbatim
-navarrop@caraja:~$ cd Bureau/simgrid-trunk/
-navarrop@caraja:~/Bureau/simgrid-trunk$ cmake ./
-
-GTnetS doesn't works : set -Ddisable_gtnets=on                  <-|some warnings are printed 
-with_context auto change to ucontext                           <-|
-(skaddr)                                                       <--info (needed)
-(sksize)                                                       <--info (needed)
-Make : src/simgrid.jar with : /usr/bin/javac                   <--info (if java)
-Make examples/java with : /usr/bin/javac                       <--info (if java)
-
-Configuration of package `simgrid' (revision 7209M) on arch (=4):
-       BUILDNAME :             UCONTEXT                                <-- name of the compilation regarding to cdash
-            SITE :             Linux_Ubuntu 9.10_x86_64                <-- distribution of the local machine regarding to cdash
-
-       Compiler: c++ :         /usr/bin/c++
-              version:         c++ (Ubuntu 4.4.1-4ubuntu9) 4.4.1
-                 c   :         /usr/bin/gcc
-              version:         gcc (Ubuntu 4.4.1-4ubuntu9) 4.4.1
-
-       CFlags:                 -g3
-       CPPFlags:               
-       LDFlags:                
-
-       Context backend:        ucontext
-       Compile Gtnets:         0
-                 path:         
-       Compile Java:           1
-       Compile Lua:            1
-       Compile Ruby:           0
-
-       Maintainer mode:        OFF
-       Supernovae mode:        OFF
-
-       Simgrid dependencies:   -ldl -llua5.1
-       Gras dependencies:      pthread
-       Ruby dependencies:      
-       Smpi dependencies:      
-
-       USER_PREFIX:            /usr/local
-       INSTALL_PREFIX:         /usr/local
-
--- Configuring done
--- Generating done
--- Build files have been written to: /home/navarrop/Bureau/simgrid-trunk
+make install
 \endverbatim
-Here all options are checked and printed. If it doesn't match with your configuration 
-it is probably due to a wrong configuration.
 
 \subsection faq_cmakehowto How to modified sources files for developers
 
@@ -800,7 +772,7 @@ add_executable(get_sender get_sender.c)                                     #add_executable(<name_of_target> <sr
 target_link_libraries(get_sender simgrid m pthread -fprofile-arcs)     #target_link_libraries(<name_of_targe> <dependencies>)
 \endverbatim
 
-Then you have to modified <project/directory>/buildtools/Cmake/src/CMakeMakeExeLib.txt and add 
+Then you have to modified <project/directory>/buildtools/Cmake/CMakeMakeExeLib.txt and add 
 this line :
 \verbatim
 add_subdirectory(${PROJECT_DIRECTORY}/<path_where_is_CMakeList.txt>)
@@ -808,7 +780,7 @@ add_subdirectory(${PROJECT_DIRECTORY}/<path_where_is_CMakeList.txt>)
 
 \subsubsection faq_cmakehowto2 Delete/add sources to lib.
 
-If you want modified, add or delete source files from a library you have to edit <project/directory>/buildtools/Cmake/src/CMakeDefinePackages.txt
+If you want modified, add or delete source files from a library you have to edit <project/directory>/buildtools/Cmake/CMakeDefinePackages.txt
 
 \verbatim
 set(JMSG_JAVA_SRC
@@ -829,7 +801,7 @@ set(JMSG_JAVA_SRC
 
 \subsubsection faq_cmakehowto3 Add test
 
-If you want modified, add or delete tests you have to edit <project/directory>/buildtools/Cmake/src/CMakeTest.txt 
+If you want modified, add or delete tests you have to edit <project/directory>/buildtools/Cmake/CMakeTest.txt 
 with this function : ADD_TEST(<name> <bin> <ARGS>)
 
 \verbatim
@@ -898,36 +870,20 @@ Here is a list of files involved into cmake build (relative to project directory
 
 Cmake sources:
        ./doc/CMakeLists.txt
-       ./buildtools/Cmake/src/CMakeCompleteInFiles.txt
-       ./buildtools/Cmake/src/CMakeDocs.txt
-       ./buildtools/Cmake/src/CMakeMakeExeLib.txt
-       ./buildtools/Cmake/src/CMakePrintArgs.txt
-       ./buildtools/Cmake/src/CMakeDefinePackages.txt
-       ./buildtools/Cmake/src/CMakeFlags.txt
-       ./buildtools/Cmake/src/CMakeSupernovae.txt
-       ./buildtools/Cmake/src/CMakeDistrib.txt
-       ./buildtools/Cmake/src/CMakeMaintainerMode.txt
-       ./buildtools/Cmake/src/CMakeOption.txt
-       ./buildtools/Cmake/src/CMakeTest.txt
-       ./buildtools/Cmake/src/CTestConfig.cmake
-
-Test files for define properties :
-       ./buildtools/Cmake/prog_test/prog_GRAS_ARCH.c
-       ./buildtools/Cmake/prog_test/prog_max_size.c
-       ./buildtools/Cmake/prog_test/prog_sem_init.c
-       ./buildtools/Cmake/prog_test/prog_stackgrowth.c
-       ./buildtools/Cmake/prog_test/prog_vsnprintf.c
-       ./buildtools/Cmake/prog_test/prog_AC_CHECK_MCSC.c
-       ./buildtools/Cmake/prog_test/prog_GRAS_CHECK_STRUCT_COMPACTION.c
-       ./buildtools/Cmake/prog_test/prog_mutex_timedlock.c
-       ./buildtools/Cmake/prog_test/prog_sem_timedwait.c
-       ./buildtools/Cmake/prog_test/prog_stacksetup.c
-       ./buildtools/Cmake/prog_test/prog_getline.c
-       ./buildtools/Cmake/prog_test/prog_gtnets.cpp
-       ./buildtools/Cmake/prog_test/prog_printf_null.c
-       ./buildtools/Cmake/prog_test/prog_snprintf.c
-       ./buildtools/Cmake/prog_test/prog_va_copy.c
-
+       ./buildtools/Cmake/AddTests.cmake
+       ./buildtools/Cmake/CompleteInFiles.cmake
+       ./buildtools/Cmake/CTestConfig.cmake
+       ./buildtools/Cmake/DefinePackages.cmake
+       ./buildtools/Cmake/Distrib.cmake
+       ./buildtools/Cmake/Flags.cmake
+       ./buildtools/Cmake/GenerateDocs.cmake
+       ./buildtools/Cmake/MaintainerMode.cmake
+       ./buildtools/Cmake/MakeExeLib.cmake
+       ./buildtools/Cmake/MakeJava.cmake
+       ./buildtools/Cmake/Option.cmake
+       ./buildtools/Cmake/PrintArgs.cmake
+       ./buildtools/Cmake/Supernovae.cmake
+       
 CMakeLists for each binaries or examples:
        ./CMakeLists.txt
        ./src/CMakeLists.txt
@@ -1671,13 +1627,34 @@ Other models have been proposed and implemented since then (see for example
 <a href="http://mescal.imag.fr/membres/arnaud.legrand/articles/simutools09.pdf">Accuracy Study and Improvement of Network Simulation in the SimGrid Framework</a>)
 and can be activated at runtime. For example:
 \verbatim
-./mycode platform.xml deployment.xml --cfg=workstation_model:compound --cfg=network_model:LV08 -cfg=cpu_model:Cas01
+./mycode platform.xml deployment.xml --cfg=workstation/model:compound --cfg=network/model:LV08 -cfg=cpu/model:Cas01
 \endverbatim
 
 Possible models for the network are currently "Constant", "CM02",
 "LegrandVelho", "GTNets", Reno", "Reno2", "Vegas". Others will
 probably be added in the future and many of the previous ones are
-experimental and are likely to disappear without notice...
+experimental and are likely to disappear without notice... To know the
+list of the currently  implemented models, you should use the
+--help-models command line option.
+
+\verbatim
+./masterslave_forwarder ../small_platform.xml deployment_masterslave.xml  --help-models
+Long description of the workstation models accepted by this simulator:
+  CLM03: Default workstation model, using LV08 and CM02 as network and CPU
+  compound: Workstation model allowing you to use other network and CPU models
+  ptask_L07: Workstation model with better parallel task modeling
+Long description of the CPU models accepted by this simulator:
+  Cas01_fullupdate: CPU classical model time=size/power
+  Cas01: Variation of Cas01_fullupdate with partial invalidation optimization of lmm system. Should produce the same values, only faster
+  CpuTI: Variation of Cas01 with also trace integration. Should produce the same values, only faster if you use availability traces
+Long description of the network models accepted by this simulator:
+  Constant: Simplistic network model where all communication take a constant time (one second)
+  CM02: Realistic network model with lmm_solve and no correction factors
+  LV08: Realistic network model with lmm_solve and these correction factors: latency*=10.4, bandwidth*=.92, S=8775
+  Reno: Model using lagrange_solve instead of lmm_solve (experts only)
+  Reno2: Model using lagrange_solve instead of lmm_solve (experts only)
+  Vegas: Model using lagrange_solve instead of lmm_solve (experts only)
+\endverbatim
 
 \subsection faq_tracing Tracing Simulations for Visualization
 
@@ -2118,6 +2095,18 @@ $ defaults write Triva 'bcompute Color' '1 0 0'
 \endverbatim
 Where the three numbers in each line are the RGB color with values from 0 to 1.
 
+\subsection faq_modelchecking Model-Checking
+\subsubsection faq_modelchecking_howto How to use it
+To enable the experimental SimGrid model-checking support the program should
+be executed with the command line argument 
+\verbatim
+--cfg=model-check:1 
+\endverbatim
+Properties are expressed as assertions using the function
+\verbatim
+void MC_assert(int prop);
+\endverbatim
+
 \section faq_troubleshooting Troubleshooting
 
 \subsection faq_trouble_lib_compil SimGrid compilation and installation problems