X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/a0ef4e1f3c5c8c268f507e68650a21c8c75fc906..10b586757ab8526c1e1e25317898b21a0c430e02:/doc/install.doc

diff --git a/doc/install.doc b/doc/install.doc
index ce35441cd4..d912e8b2e2 100644
--- a/doc/install.doc
+++ b/doc/install.doc
@@ -24,6 +24,9 @@ For Unix and MacOS:
   \li c and c++ compiler
   \li ccmake for graphical used of CMake
   \li cmake <a href="http://www.cmake.org/cmake/resources/software.html">(download page)</a>
+                                                                                                                                                                                               
+On MacOSX some users reported that it is still possible to build with clang, provided that you use the 
+following package versions clang3.1 and clang++3.1. If it fails on you, try to use gcc47 (port install gcc47).
 
 For Windows :
   \li cmake 2.8 <a href="http://www.cmake.org/cmake/resources/software.html">(download page)</a>
@@ -31,6 +34,14 @@ For Windows :
   \li perl <a href="http://www.activestate.com/activeperl/downloads">(download page)</a>
   \li git <a href="http://msysgit.googlecode.com/files/Git-1.7.4-preview20110204.exe">(download page)</a>
   
+Note that if you want change the compiler, you can simply specify the environment variables CC and CXX.
+\verbatim
+ 	export CC=gcc-4.4
+ 	export CXX=g++-4.4
+ 	export CC=clang
+ 	export CXX=clang++
+\endverbatim 
+
 \subsubsection install_cmakeoption1 Liste of options
 
 \verbatim
@@ -54,12 +65,9 @@ For Windows :
 	enable_supernovae       	ON/OFF or TRUE/FALSE or 1/0
 	enable_msg_deprecated   	ON/OFF or TRUE/FALSE or 1/0                                                                                                                                                                                                                                                                               
 	enable_print_message    	ON/OFF or TRUE/FALSE or 1/0 
-	custom_flags 			<flags>
 	gtnets_path			<path_to_gtnets_directory>
 	ns3_path			<path_to_ns3_directory>
 	CMAKE_INSTALL_PREFIX		<path_to_install_directory>
-	CMAKE_C_COMPILER		<path_to_compiler>
-	CMAKE_CXX_COMPILER		<path_to_compiler>
 	pipol_user			<pipol_username>
 \endverbatim
                                                                                                                                                           
@@ -101,18 +109,12 @@ For Windows :
   
   \li enable_print_message : When set to true configuration print more debug output.
   
-  \li custom_flags : If user wants to use a specific flag during compilation, give here.
-
   \li gtnets_path : Path to gtnets install directory (ex /usr)
   
   \li ns3_path : Path to ns3 install directory (ex /usr)
 
   \li CMAKE_INSTALL_PREFIX : Path where are installed lib/ doc/ and include/ directories (ex /usr/local)
   
-  \li CMAKE_C_COMPILER : Change the c compiler.
-  
-  \li CMAKE_CXX_COMPILER : Change the c++ compiler. 
-  
   \li pipol_user : specify your pipol username if you want to use the pipol-remote command.
 
 \subsubsection install_cmakeoption3 Initialisation
@@ -135,7 +137,6 @@ enable_jedule 	 		off
 enable_latency_bound_tracking 	off 
 enable_lib_static		off
 CMAKE_INSTALL_PREFIX		/usr/local
-custom_flags			null
 gtnets_path			null
 pipol_user			null
 \endverbatim
@@ -397,6 +398,22 @@ can use the SimGrid Ruby bindings in a virtual machine using
 VirtualBox. Thanks to him for that. You can find his project here:
 https://github.com/aespinosa/simgrid-vagrant
 
+\section install_mac Installing the SimGrid framework on Mac OS X
+
+The Mac OS X system is part of the UNIX familly, but it exibits some
+specificities that complicate a bit the build of SimGrid. Current
+versions of SimGrid (3.7.x) can only be build with the GCC Compiler,
+but recent OS X version provide only an ancient version of that tool
+in the hope to see the users switch to the LLVM compiler family. The
+problem is that SimGrid uses internal libraries of GCC, for stack
+manipulation for example. We are working on removing this dependency
+onto gcc to ease the build process, but this is still ongoing.
+
+For the time being, you need to get a recent version of GCC on your
+system to build SimGrid. Version 3.7.1  was successfully built on Mac
+Lion 10.7.4 using a GCC compiler retrieved from macport. The package
+used were gcc47, and the binary in the package were gcc-mp-4.7.
+
 \section install_setting_MSG Setting up your own MSG code
 
 Do not build your simulator by modifying the SimGrid examples.  Go