ENH: improved handling of gmp/mpfr library settings (issue #674)

- export library path for gmp/mpfr from CGAL config files.
  This is required when non-system gmp/mpfr libraries are being
  used, but not using a ThirdParty compiler installation.

- automatically handle lib/ vs lib64/ (eg, for central installations)
  for packages such as boost, CGAL, etc. While the ThirdParty
  compilation of these will normally land in lib64/, this may not be
  the case when they are supplied by another means.

- reworked the handling of foamEtcFile and foamCleanPath for less
  clutter in the configuration files.
  Added the bin/tools/lib-dir script to handle logic that is
  too complex to easily manage in csh.

etc/config.csh/example/compiler

@@ -11,15 +11,15 @@
 #
 # File
 #     config.csh/example/compiler
+#     - sourced by OpenFOAM-*/etc/config.csh/settings
 #
 # Description
 #     Example of fine tuning ThirdParty compiler settings for OpenFOAM
-#     Sourced from OpenFOAM-<VERSION>/etc/config.csh/settings
 #
 #------------------------------------------------------------------------------
 
 # Load the standard versions
-eval `$WM_PROJECT_DIR/bin/foamEtcFile -csh -mode=o config.csh/compiler`
+eval `$WM_PROJECT_DIR/bin/foamEtcFile -mode=o -csh -config compiler`
 
 # Modify/override compiler settings
 switch ("$WM_COMPILER")

etc/config.csh/example/openmpi

@@ -11,14 +11,13 @@
 #
 # File
 #     config.csh/example/openmpi
+#     - sourced by OpenFOAM-*/etc/config.csh/mpi
 #
 # Description
 #     Example of fine tuning openmpi settings for OpenFOAM
-#     Sourced from OpenFOAM-<VERSION>/etc/config.csh/settings
 #
 #------------------------------------------------------------------------------
 
-# Modified openmpi settings
 setenv FOAM_MPI openmpi-3.0.0
 
 #------------------------------------------------------------------------------

etc/config.csh/example/paraview

@@ -22,8 +22,7 @@
 #
 #------------------------------------------------------------------------------
 
-# Use shipped paraview config file (-mode=o) with a different ParaView_VERSION
-
+# Use standard paraview config file (-mode=o) with a different ParaView_VERSION
 set foamFile=`$WM_PROJECT_DIR/bin/foamEtcFile -mode=o config.csh/paraview`
 if ( $status == 0 ) source $foamFile ParaView_VERSION=5.4.0
 

etc/config.csh/example/prefs.csh

@@ -11,12 +11,10 @@
 #
 # File
 #     config.csh/example/prefs.csh
+#     - sourced by OpenFOAM-*/etc/cshrc
 #
 # Description
-#     Preset variables for the OpenFOAM configuration - C-Shell shell syntax.
-#
-#     The prefs.csh file will be sourced by the OpenFOAM etc/cshrc when it is
-#     found by foamEtcFile.
+#     Example of preset variables for the OpenFOAM configuration (C-Shell shell)
 #
 # See also
 #     'foamEtcFile -help' or 'foamEtcFile -list' for information about the
@@ -24,13 +22,8 @@
 #
 #------------------------------------------------------------------------------
 
-#- Compiler location:
 setenv WM_COMPILER_TYPE ThirdParty
-
-#- Compiler:
 setenv WM_COMPILER Clang
-
-#- MPI implementation:
 setenv WM_MPLIB SYSTEMOPENMPI
 
 #------------------------------------------------------------------------------