OTP-8323 Cross compilation improvements and other build system

          improvements.

          Most notable:

          Lots of cross compilation improvements. The old cross compilation
          support was more or less non-existing as well as broken. Please,
          note that the cross compilation support should still be
          considered as experimental. Also note that old cross compilation
          configurations cannot be used without modifications. For more
          information on cross compiling Erlang/OTP see the
          $ERL_TOP/xcomp/README file.

          Support for staged install using <url
          href="http://www.gnu.org/prep/standards/html_node/DESTDIR.html">D
          ESTDIR</url>. The old broken INSTALL_PREFIX has also been fixed.
          For more information see the $ERL_TOP/README file.

          Documentation of the release target of the top Makefile. For more
          information see the $ERL_TOP/README file.

          make install now by default creates relative symbolic links
          instead of absolute ones. For more information see the
          $ERL_TOP/README file.

          $ERL_TOP/configure --help=recursive now works and prints help for
          all applications with configure scripts.

          Doing make install, or make release directly after make all no
          longer triggers miscellaneous rebuilds.

          Existing bootstrap system is now used when doing make install, or
          make release without a preceding make all.

          The crypto and ssl applications use the same runtime library path
          when dynamically linking against libssl.so and libcrypto.so. The
          runtime library search path has also been extended.

          The configure scripts of erl_interface and odbc now search for
          thread libraries and thread library quirks the same way as erts
          do.

          The configure script of the odbc application now also looks for
          odbc libraries in lib64 and lib/64 directories when building on a
          64-bit system.

          The config.h.in file in the erl_interface application is now
          automatically generated in instead of statically updated which
          reduces the risk of configure tests without any effect.

5 files changed, 139 insertions, 29 deletions

diff --git a/xcomp/README b/xcomp/README
index 4cb577471a..f4285cd16f 100644
--- a/xcomp/README
+++ b/xcomp/README
@@ -1,5 +1,5 @@
 ===============================================================================
-                          Cross compiling Erlang/OTP
+                          Cross Compiling Erlang/OTP
 ===============================================================================
 
 %CopyrightBegin%
@@ -244,14 +244,14 @@ build machine and the cross host system.
 
     $ ./otp_build boot -a
 
- 'otp_build boot -a' will first build a bootstrap system
-for the build machine and then do the cross build of the system.
+`otp_build boot -a' will first build a bootstrap system for the build machine
+and then do the cross build of the system.
 
   [11]
 
     $ ./otp_build release -a <RELEASE_DIR>
 
-'otp_build release -a' will do the same as [5], and you will after this have
+`otp_build release -a' will do the same as [5], and you will after this have
 to do a manual install either by doing [6], or [7].
 
 ======== Currently used configuration variables ===============================
@@ -312,13 +312,15 @@ not need to set these variables (where `<HOST>' is what has been passed as
 
 * CXXFLAGS - C++ compiler flags.
 
-* LD - Linker
+* LD - Linker.
 
 * LDFLAGS - Linker flags.
 
--- Dynamic Erlang Driver linker flags. --
+* LIBS - Libraries.
 
-NOTE! Either define all or non of the DED_LD* variables.
+-- Dynamic Erlang Driver linker flags --
+
+NOTE! Either set all or non of the DED_LD* variables.
 
 * DED_LD - Linker.
 
@@ -328,11 +330,23 @@ NOTE! Either define all or non of the DED_LD* variables.
      This flag should set a specific runtime library path for the shared
      library at link time.
 
+-- Large file support --
+
+NOTE! Either set all or non of the LFS_* variables.
+
+* LFS_CFLAGS - Large file support C compiler flags.
+
+* LFS_LDFLAGS - Large file support linker flags.
+
+* LFS_LIBS - Large file support libraries.
+
 -- Other tools --
 
-* RANLIB - ranlib
+* RANLIB - `ranlib' archive index tool.
 
-* AR - ar
+* AR - `ar' archiving tool.
+
+* GETCONF - `getconf' system configuration inspection tool.
 
 -------- Cross System Root Locations ------------------------------------------
 
@@ -356,6 +370,10 @@ These tests cannot (always) be done automatically when cross compiling. You
 usually does not need to set these variables. Only set these if you really
 know what you are doing.
 
+Note that some of these values will override results of tests performed
+by `configure', and some will not be used until `configure' is sure that
+it cannot figure the result out.
+
 The `configure' script will issue a warning when a default value is used.
 When a variable has been set, no warning will be issued.
 
diff --git a/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf b/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf
index 67da8b5abb..5ceb4ec145 100644
--- a/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf
+++ b/xcomp/erl-xcomp-TileraMDE2.0-tilepro.conf
@@ -94,15 +94,18 @@ erl_xcomp_configure_flags="--without-termcap"
 ## CXXFLAGS - C++ compiler flags.
 #CXXFLAGS=
 
-## LD - Linker
+## LD - Linker.
 #LD=
 
 ## LDFLAGS - Linker flags.
 #LDFLAGS=
 
-### -- Dynamic Erlang Driver linker flags. --
+## LIBS - Libraries.
+#LIBS=
 
-### NOTE! Either define all or non of the DED_LD* variables.
+### -- Dynamic Erlang Driver linker flags --
+
+### NOTE! Either set all or non of the DED_LD* variables.
 
 ## DED_LD - Linker.
 #DED_LD=
@@ -115,14 +118,30 @@ erl_xcomp_configure_flags="--without-termcap"
 ##    library at link time.
 #DED_LD_FLAG_RUNTIME_LIBRARY_PATH=
 
+### -- Large file support --
+
+### NOTE! Either set all or non of the LFS_* variables.
+
+## LFS_CFLAGS - Large file support C compiler flags.
+#LFS_CFLAGS=
+
+## LFS_LDFLAGS - Large file support linker flags.
+#LFS_LDFLAGS=
+
+## LFS_LIBS - Large file support libraries.
+#LFS_LIBS=
+
 ### -- Other tools --
 
-## RANLIB - ranlib
+## RANLIB - `ranlib' archive index tool.
 #RANLIB=
 
-## AR - ar
+## AR - `ar' archiving tool.
 #AR=
 
+## GETCONF - `getconf' system configuration inspection tool.
+#GETCONF=
+
 ### ---- Cross System Root Locations ------------------------------------------
 
 ## erl_xcomp_sysroot - Absolute cross system root path.
@@ -147,6 +166,10 @@ erl_xcomp_sysroot="$TILERA_ROOT/tile"
 ### usually does not need to set these variables. Only set these if you really
 ### know what you are doing.
 
+### Note that some of these values will override results of tests performed
+### by `configure', and some will not be used until `configure' is sure that
+### it cannot figure the result out.
+
 ### The `configure' script will issue a warning when a default value is used.
 ### When a variable has been set, no warning will be issued.
 
diff --git a/xcomp/erl-xcomp-vxworks_ppc32.conf b/xcomp/erl-xcomp-vxworks_ppc32.conf
index fbd23c2fb9..aa7c652d80 100644
--- a/xcomp/erl-xcomp-vxworks_ppc32.conf
+++ b/xcomp/erl-xcomp-vxworks_ppc32.conf
@@ -94,15 +94,18 @@ CPP="$CC $CFLAGS -E"
 ## CXXFLAGS - C++ compiler flags.
 #CXXFLAGS=
 
-## LD - Linker
+## LD - Linker.
 LD="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/ldppc"
 
 ## LDFLAGS - Linker flags.
 LDFLAGS="-mlongcall"
 
-### -- Dynamic Erlang Driver linker flags. --
+## LIBS - Libraries.
+#LIBS=
 
-### NOTE! Either define all or non of the DED_LD* variables.
+### -- Dynamic Erlang Driver linker flags --
+
+### NOTE! Either set all or non of the DED_LD* variables.
 
 ## DED_LD - Linker.
 #DED_LD=
@@ -115,14 +118,30 @@ LDFLAGS="-mlongcall"
 ##    library at link time.
 #DED_LD_FLAG_RUNTIME_LIBRARY_PATH=
 
+### -- Large file support --
+
+### NOTE! Either set all or non of the LFS_* variables.
+
+## LFS_CFLAGS - Large file support C compiler flags.
+#LFS_CFLAGS=
+
+## LFS_LDFLAGS - Large file support linker flags.
+#LFS_LDFLAGS=
+
+## LFS_LIBS - Large file support libraries.
+#LFS_LIBS=
+
 ### -- Other tools --
 
-## RANLIB - ranlib
+## RANLIB - `ranlib' archive index tool.
 RANLIB="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/ranlibppc"
 
-## AR - ar
+## AR - `ar' archiving tool.
 AR="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/arppc"
 
+## GETCONF - `getconf' system configuration inspection tool.
+#GETCONF=
+
 ### ---- Cross System Root Locations ------------------------------------------
 
 ## erl_xcomp_sysroot - Absolute cross system root path.
@@ -147,6 +166,10 @@ AR="$WIND_BASE/gnu/3.4.4-vxworks-6.3/$WIND_HOST_TYPE/bin/arppc"
 ### usually does not need to set these variables. Only set these if you really
 ### know what you are doing.
 
+### Note that some of these values will override results of tests performed
+### by `configure', and some will not be used until `configure' is sure that
+### it cannot figure the result out.
+
 ### The `configure' script will issue a warning when a default value is used.
 ### When a variable has been set, no warning will be issued.
 
diff --git a/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf b/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf
index b6730cff0a..1d57876172 100644
--- a/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf
+++ b/xcomp/erl-xcomp-x86_64-saf-linux-gnu.conf
@@ -94,15 +94,18 @@ CXX=x86_64-saf-g++
 ## CXXFLAGS - C++ compiler flags.
 #CXXFLAGS=
 
-## LD - Linker
+## LD - Linker.
 LD=x86_64-saf-ld
 
 ## LDFLAGS - Linker flags.
 #LDFLAGS=
 
-### -- Dynamic Erlang Driver linker flags. --
+## LIBS - Libraries.
+#LIBS=
 
-### NOTE! Either define all or non of the DED_LD* variables.
+### -- Dynamic Erlang Driver linker flags --
+
+### NOTE! Either set all or non of the DED_LD* variables.
 
 ## DED_LD - Linker.
 #DED_LD=
@@ -115,14 +118,30 @@ LD=x86_64-saf-ld
 ##    library at link time.
 #DED_LD_FLAG_RUNTIME_LIBRARY_PATH=
 
+### -- Large file support --
+
+### NOTE! Either set all or non of the LFS_* variables.
+
+## LFS_CFLAGS - Large file support C compiler flags.
+#LFS_CFLAGS=
+
+## LFS_LDFLAGS - Large file support linker flags.
+#LFS_LDFLAGS=
+
+## LFS_LIBS - Large file support libraries.
+#LFS_LIBS=
+
 ### -- Other tools --
 
-## RANLIB - ranlib
+## RANLIB - `ranlib' archive index tool.
 RANLIB=x86_64-saf-ranlib
 
-## AR - ar
+## AR - `ar' archiving tool.
 AR=x86_64-saf-ar
 
+## GETCONF - `getconf' system configuration inspection tool.
+#GETCONF=
+
 ### ---- Cross System Root Locations ------------------------------------------
 
 ## erl_xcomp_sysroot - Absolute cross system root path.
@@ -147,6 +166,10 @@ erl_xcomp_sysroot="$SAF_SYSROOT_X86_64"
 ### usually does not need to set these variables. Only set these if you really
 ### know what you are doing.
 
+### Note that some of these values will override results of tests performed
+### by `configure', and some will not be used until `configure' is sure that
+### it cannot figure the result out.
+
 ### The `configure' script will issue a warning when a default value is used.
 ### When a variable has been set, no warning will be issued.
 
diff --git a/xcomp/erl-xcomp.conf.template b/xcomp/erl-xcomp.conf.template
index 9242318577..afbef66af1 100644
--- a/xcomp/erl-xcomp.conf.template
+++ b/xcomp/erl-xcomp.conf.template
@@ -94,15 +94,18 @@
 ## CXXFLAGS - C++ compiler flags.
 #CXXFLAGS=
 
-## LD - Linker
+## LD - Linker.
 #LD=
 
 ## LDFLAGS - Linker flags.
 #LDFLAGS=
 
-### -- Dynamic Erlang Driver linker flags. --
+## LIBS - Libraries.
+#LIBS=
 
-### NOTE! Either define all or non of the DED_LD* variables.
+### -- Dynamic Erlang Driver linker flags --
+
+### NOTE! Either set all or non of the DED_LD* variables.
 
 ## DED_LD - Linker.
 #DED_LD=
@@ -115,14 +118,30 @@
 ##    library at link time.
 #DED_LD_FLAG_RUNTIME_LIBRARY_PATH=
 
+### -- Large file support --
+
+### NOTE! Either set all or non of the LFS_* variables.
+
+## LFS_CFLAGS - Large file support C compiler flags.
+#LFS_CFLAGS=
+
+## LFS_LDFLAGS - Large file support linker flags.
+#LFS_LDFLAGS=
+
+## LFS_LIBS - Large file support libraries.
+#LFS_LIBS=
+
 ### -- Other tools --
 
-## RANLIB - ranlib
+## RANLIB - `ranlib' archive index tool.
 #RANLIB=
 
-## AR - ar
+## AR - `ar' archiving tool.
 #AR=
 
+## GETCONF - `getconf' system configuration inspection tool.
+#GETCONF=
+
 ### ---- Cross System Root Locations ------------------------------------------
 
 ## erl_xcomp_sysroot - Absolute cross system root path.
@@ -147,6 +166,10 @@
 ### usually does not need to set these variables. Only set these if you really
 ### know what you are doing.
 
+### Note that some of these values will override results of tests performed
+### by `configure', and some will not be used until `configure' is sure that
+### it cannot figure the result out.
+
 ### The `configure' script will issue a warning when a default value is used.
 ### When a variable has been set, no warning will be issued.