updated to include cmake.

INSTALL

@@ -1,17 +1,80 @@
 #---------------------------------------------------------------------
 # INSTALL
-# AS/BMW, 2014/02/11; 2011/01/27
 #---------------------------------------------------------------------
 
-To get it all build:
+There are currently 2 wasy to build musrfit:
+
+1) via the automake tool chain (this will phase out until 2019)
+2) via the cmake tool chain (this will be the default starting from now)
+
+In the following it is assumed that the system variable ROOTSYS is already
+defined and pointing to the place where CERN/ROOT is installed.
+
+#----------------------------------
+# Install via automake tool chain
+#----------------------------------
+
+To get it build:
 
    sh autogen.sh
-   ./configure --prefix=/opt/cern/root       (or where ever musrfit should be installed)
+   ./configure --prefix=$ROOTSYS             (or where ever musrfit should be installed)
    make
    make install                              (as superuser -- maybe)
+   /sbin/ldconfig                            (as superuser)   
+
+configure comes with a couple of options. For details either execute
+
+  ./configure --help
+
+or check under http://lmu.web.psi.ch/musrfit/user/MUSR/MusrFitSetup.html
+for a more detailed description.
+
+An example with NeXus support and BMWlibs needed would look like this
+
+   sh autogen.sh
+   ./configure --enable-NeXus --enable-BMWlibs --prefix=$ROOTSYS 
+   make 
+   make install                              (as superuser -- maybe)
+   /sbin/ldconfig                            (as superuser)
    
 In the optimal case, everything is set up ;-)
 
+#----------------------------------
+# Install via cmake tool chain
+#----------------------------------
+
+cmake minimal required version is 3.6.
+
+musrfit supports only out-of-source cmake build! Hence, go to the musrfit
+directory and
+
+   mkdir build
+   cd build 
+   cmake ../ -DCMAKE_INSTALL_PREFIX=$ROOTSYS (or where ever musrfit should be installed)
+   cmake --build ./ --clean-first
+   make install                              (as superuser -- maybe)
+   /sbin/ldconfig                            (as superuser)
+    
+cmake configuration allows a couple of switches.  For details check the user
+docu under 
+
+   http://lmu.web.psi.ch/musrfit/user/MUSR/MusrFitSetup.html
+
+An example with NeXus support and BMWlibs needed would look like this
+
+   mkdir build
+   cd build
+   cmake ../ -Dnexus=1 -DBMWlibs=1 -DCMAKE_INSTALL_PREFIX=$ROOTSYS 
+   cmake --build ./ --clean-first
+   make install                              (as superuser -- maybe)
+   /sbin/ldconfig                            (as superuser)
+
+In the optimal case, everything is set up ;-)
+
+#----------------------------------
+# Link to the docu
+#----------------------------------
+
 More information about the software requirements and the installation can be found at:
 
 http://lmu.web.psi.ch/musrfit/user/MUSR/MusrFitSetup.html