From 63041a9b874162b357d7cccb3c26e0e78aaddd93 Mon Sep 17 00:00:00 2001
From: Gabriel Studer <gabriel.studer@unibas.ch>
Date: Fri, 6 Nov 2020 08:37:12 +0100
Subject: [PATCH] Add Known Issues to compile instructions

First entry is about adding the -pthread flag to resolve linking
problems. Has been observed on the scicore cluster and reported
by Yuri (FreeBSD 12.2).
---
 modules/doc/install.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/modules/doc/install.rst b/modules/doc/install.rst
index 4dbfffd13..b4382b7c9 100644
--- a/modules/doc/install.rst
+++ b/modules/doc/install.rst
@@ -268,6 +268,13 @@ Build Options
   * `HIDDEN_VISIBILITY` can be turned on to add "-fvisibility=hidden" to gcc's
     compile flags (only if GNU compiler used). By default, this is switched off.
 
+Known Issues
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Depending on how the dependecies (e.g. Boost) are compiled, linking might fail
+  with something like: `error: undefined reference to pthread_condattr_destroy`.
+  Add "-pthread" to the linking options by appending the following to your cmake
+  command: `-DCMAKE_EXE_LINKER_FLAGS=" -pthread"`
 
 Example Configurations
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-- 
GitLab