Changes between Version 2 and Version 3 of InstallingFACT++

Timestamp:

08/05/18 15:31:45 (6 years ago)

Author:

tbretz

Comment:

--

InstallingFACT++

@@ -1 +1 @@
 == Compiling FACT++ ==
 
-First you need to get FACT++ from the svn-repository
+First you need to get FACT++ from the svn-repository. The default command will checkout it into a sub-directory called "{{{directory}}}" at the current directory. It will be created if not existing. If the argument is omitted, the default directory is FACT++.
 
 {{{
-svn checkout https://www.fact-project.org/svn/trunk/FACT++
+[0] svn checkout https://www.fact-project.org/svn/trunk/FACT++ [directory]
+[1] cd FACT++
 }}}
 
-Now create a new subdirectory
+Now create a new sub-directory in your main source directory (here assuming the default name was used)
 
 {{{
-cd FACT++
-mkdir build
+[2] mkdir build
+[3] cd build
 }}}
 
-And call {{{cmake}}} from there
+And call {{{cmake}}} from there (the "{{{..}}}" is intentional!)
 
 {{{
-cmake ..
+[4] cmake ..
 }}}
 
-to compile with clang, you might want to do
+to compile with '''clang''', you might want to change the compilers by calling
 {{{
-cmake -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ ..
+[4] cmake -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ ..
 }}}
 
-Note that not all versions of clang are compatible with all version of the boost-libraries.
+instead. Note that not all versions of {{{clang}}} are compatible with all version of the boost-libraries on Ubuntu. You might have to try different versions. (However, it is worth it, because {{{clang}}} is much faster).
 
-If you only want to compile the basic tools (like rootifysql) you can add {{{-DTOOLS_ONLY=1}}} when calling {{{cmake}}}.
+If you only want to compile the basic tools (rootifysql, root2sql, fits2sql, fitsdump and zfits) you can add {{{-DTOOLS_ONLY=1}}} when calling {{{cmake}}}. This simplifies compilation because less packages are required (for example the whole QT stuff is not needed).
 
 If a package is missing, you will see an error which looks like this
@@ -42 +43 @@
 It is a bit tricky to find out which package is missing at the moment. In this case, it is the development package of the nova library (libnova-dev).
 
-Then call {{{make}}}.
+Then call {{{make}}} or {{{make -jN}}} where '''N''' is the numbers of threads you want to utilize (check the number of CPU cores you can keep busy).
 
 == Packaging FACT++ ==
 
-For the tool-set, you can build a archive file and Debian packages by {{{make package}}}. The Debian package can then be installed with {{{dpkg -i fact++-YYWWDDHH.deb}}} while YYWWDDHH is the version number compiled from the time when cmake was called.
+Once successfully compiled, you can package the tool-set and build a tar-archive and a Debian package by 
 
+{{{
+[5] make package
+}}}
+
+The Debian package can then be installed system wide with 
+
+{{{
+[6] dpkg -i fact++-YYWWDDHH.deb
+}}} 
+
+where '''YYWWDDHH''' is the version number compiled from the time when {{{cmake}}} was called.
+