From 07e333a073c229611dea641b1cfe500df16b09b7 Mon Sep 17 00:00:00 2001
From: Guillaume Pasero <guillaume.pasero@c-s.fr>
Date: Wed, 29 Mar 2017 19:22:24 +0200
Subject: [PATCH] DOC: caveats for Linux installation

---
 Documentation/Cookbook/rst/Installation_Linux.txt | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/Documentation/Cookbook/rst/Installation_Linux.txt b/Documentation/Cookbook/rst/Installation_Linux.txt
index 8a6e941d15..017106e86b 100644
--- a/Documentation/Cookbook/rst/Installation_Linux.txt
+++ b/Documentation/Cookbook/rst/Installation_Linux.txt
@@ -11,6 +11,11 @@ double-click on the file, or with the command line :
    chmod +x OTB-|release|-Linux64.run
    ./OTB-|release|-Linux64.run
 
+The self-extractible archive only needs common tools found on most Linux
+distributions ("sed", "grep", "find", "cat", "printf", "ln", ...). However, be
+aware that it requires tools such as "which" and "file" (they are not always
+present, for instance when building a container).
+
 Please note that the resulting installation is not meant to be moved,
 you should uncompress the archive in its final location. Once the
 archive is extracted, the directory structure is made of:
@@ -33,7 +38,15 @@ archive is extracted, the directory structure is made of:
 
 In order to run the command line launchers, this package doesn’t require
 any special library that is not present in most modern Linux
-distributions. The graphical executable (otbgui launchers, Monteverdi
+distributions. There is a small caveat for "expat" though. The binaries depend
+on "libexpat.so", which can be supplied by most package managers (apt, yum, ...).
+If not already present, look for one of the following packages :
+
+::
+
+    libexpat-dev   libexpat1-dev
+
+The graphical executable (otbgui launchers, Monteverdi
 and Mapla) use the X11 libraries, which are widely used in a lot of
 distributions :
 
-- 
GitLab