Merge branch 'manual_lxplus' into 'master'

Manual: Add subsection on lxplus installation

See merge request !410

doc/usermanual/chapters/installation.tex

@@ -80,9 +80,6 @@ $ git clone https://gitlab.cern.ch/corryvreckan/corryvreckan.git
 $ cd corryvreckan
 \end{verbatim}
 
-For an installation on \command{lxplus}, the environment variables need to be set by running \dir{source etc/setup_lxplus.sh} before proceeding with the installation as described below.
-The same script needs to be sourced any time after logging back into \command{lxplus} in order for the \command{corry} executable to be added to the \parameter{PATH} variable.
-
 \subsection{Configuration via CMake}
 \label{sec:cmake_config}
 \corry uses the CMake build system to configure, build, and install the core framework as well as all modules.
@@ -151,11 +148,20 @@ $ sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
 \end{verbatim}
 \item Create symlinks for the missing includes
 \begin{verbatim}
-$ sudo ln -s /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/* /usr/local/include/
+$ sudo ln -s /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/* \
+             /usr/local/include/
 \end{verbatim}
 \end{itemize}
 Now the library paths should work for command line compilation as well as from the Xcode IDE. As in the workflow above, CMake can be invoked from the build folder with several arguments, e.g. for use with EUDAQ:
 \begin{verbatim}
-$ cmake -DCMAKE_C_COMPILER=$(which clang) -DCMAKE_CXX_COMPILER=$(which clang++)  -DBUILD_EventLoaderEUDAQ=ON ..
+$ cmake -DCMAKE_C_COMPILER=$(which clang) -DCMAKE_CXX_COMPILER=$(which clang++) \
+        -DBUILD_EventLoaderEUDAQ=ON ..
 \end{verbatim}
-Note that for XCode12 CMake 3.18.x is required on Intel Macs (otherwise compilation target defaults to ARM64).
\ No newline at end of file
+Note that for XCode12 CMake 3.18.x is required on Intel Macs (otherwise compilation target defaults to ARM64).
+
+\subsection{LXPLUS}
+For an installation on \command{lxplus}, the environment variables need to be set by running \dir{source etc/setup_lxplus.sh} before proceeding with the installation as described below.
+The same script needs to be sourced any time after logging back into \command{lxplus} in order for the \command{corry} executable to be added to the \parameter{PATH} variable.
+
+If external dependencies such as EUDAQ2 are required, the installaton is a bit more tricky.
+Refer to the Troubleshooting section~\cite{corry-website-troubleshooting} of the project website~\cite{corry-website} for a step-by-step solution.

doc/usermanual/references.bib

@@ -200,6 +200,18 @@ author = "C. Hu-Guo and J. Baudot and G. Bertolone and A. Besson and A.S. Brogna
     month = nov,
     day = {13}
 }
+@online{corry-website,
+    title = {The \corry Project Website},
+    author = {},
+    url = {https://cern.ch/corryvreckan/},
+    note = {accessed 04~2021},
+}
+@online{corry-website-troubleshooting,
+    title = {The \corry Project Website, section Troubleshooting},
+    author = {},
+    url = {https://cern.ch/corryvreckan/page/installation/#troubleshooting},
+    note = {accessed 04~2021},
+}
 @online{rootinstallation,
     author = {Rene Brun and Fons Rademakers},
     title = {Building ROOT},