commit 66ef44906c05c0dca5de1c268572a6092141a82f
parent 521f94a8a32f6e74afa3c0640acc38cf749d2c3e
Author: Vincent Forest <vincent.forest@meso-star.com>
Date: Fri, 30 Nov 2018 14:35:48 +0100
Add a troubleshooting subsection to High-Tune
Diffstat:
3 files changed, 34 insertions(+), 9 deletions(-)
diff --git a/high-tune/high-tune.html.in b/high-tune/high-tune.html.in
@@ -99,9 +99,34 @@ $ man htmie
<p>Refer to the <a href=starter-pack.html>High-Tune: Starter Pack</a> to
quickly run a <code>htrdr</code> rendering; this archive provides input data
-and scripts that are good starting point to use <code>htrdr</code>
-license: GNU GPL version 3 or later. You can freely study, modify or extend
-them. You are also welcome to redistribute them under certain conditions; refer
-to the <a href="https://www.gnu.org/licenses/gpl.html">license</a> for
-details.</p>
+and scripts that are good starting points to use <code>htrdr</code>.
+
+<h3>Troubleshooting</h3>
+
+<p>The provided precompiled archive is built with libraries that might be
+incompatible with the ones available on your system. Typical symptoms are error
+messages displayed on invocation of the <code>htrdr</code> program such as:
+
+<pre class="code">
+htrdr: /lib/libc.so.6: version GLIBC_2.27 not found (required by htrdr)
+</pre>
+
+<p>or
+
+<pre class="code">
+htrdr: error while loading shared libraries: libmpi.so.20: ...
+</pre>
+
+<p>As a workaround, you can build <code>htrdr</code> and its dependencies on
+your system, directly from its source tree. Refer to the <a
+href="https://gitlab.com/meso-star/star-engine/tree/high_tune">High-Tune
+branch</a> of the Star-Engine repository for more informations on how to
+download, compile and install <code>htrdr</code>.
+
+<h2>License</h2>
+
+<p><code>htrdr</code> is free software released under the GPLv3+ license: GNU
+GPL version 3 or later. You can freely study, modify or extend it. You are
+also welcome to redistribute it under certain conditions; refer to the <a
+href="https://www.gnu.org/licenses/gpl.html">license</a> for details.</p>
diff --git a/high-tune/starter-pack.html.in b/high-tune/starter-pack.html.in
@@ -132,8 +132,8 @@ file that can be then displayed with a regular image viewer.
<h2>License</h2>
-<p>High-Tune: Starter Pack is released under the GPLv3+ license: GNU GPL version 3
-or later. You can freely study, modify or extend them. You are also welcome to
-redistribute them under certain conditions; refer to the <a
+<p>High-Tune: Starter Pack is released under the GPLv3+ license: GNU GPL
+version 3 or later. You can freely study, modify or extend it. You are also
+welcome to redistribute it under certain conditions; refer to the <a
href="https://www.gnu.org/licenses/gpl.html">license</a> for details.
diff --git a/meso-menu.sh b/meso-menu.sh
@@ -69,7 +69,7 @@ print_high_tune_sub_menu() {
else
echo " <li><a href=${root}high-tune/starter-pack.html>Starter Pack</a></li>"
fi
- echo " <li><a href=https://gitlab.com/meso-star/htrdr>Source code repository</a></li>"
+ echo " <li><a href=https://gitlab.com/meso-star/star-engine/tree/high_tune>Source code repository</a></li>"
echo ' </ul>'
echo ' <div id="info">'
echo ' <p>Copyright © 2018'
