ENH: update handling of versioning and make control (issue #1010)

• Use the OPENFOAM define (eg, 1806, 1812), which normally corresponds to a major release, to define an API level. This remains consistent within a release cycle and means that it is possible to manage several sub-versions and continue to have a consistent lookup.

  The current API value is updated automatically during the build and cached as meta data for later use, even when the wmake/ directory is missing or OpenFOAM has not yet be initialized.

  The version information reported on program start or with -help usage adjusted to reflect this. The build tag from git now also carries the date as being more meaningful to trace than a hash value.

• Update etc/bashrc and etc/cshrc to obtain the project directory directly instead of via its prefix directory. The value obtained corresponds to an absolute path, from which the prefix directory can be obtained.

  The combination of these changes removes the reliance on any particular directory naming convention. For example,

  With an 1812 version (API level):

  WM_PROJECT_VERSION=myVersion

  installed as /some/path/somewhere/openfoam-mySandbox

  This makes the -prefix, -foamInstall, -projectVersion, -version values of foamEtcFiles, and similar entries for foamConfigurePaths superfluous.

  WM_PROJECT_INST_DIR is no longer required or used

CONFIG: relocate WM_PROJECT_SITE default

• was /site, now /site

  This avoids several issues when installing OpenFOAM in clusters without an intermediate OpenFOAM-specific installation prefix.

  The 'site' directory may have a reserved meaning in these situations and it is undesirable to 'leak' upwards into the parent directory to look for configuration files.

  Placing the default within the project directory avoids this. Alternative locations can be given via the WM_PROJECT_SITE variable.

• removed foamExec, which was previously used when switching versions and before the bash/csh discovery logic was used

ENH: add csh support to foamConfigurePaths

resolved all discussions

added 9 commits

• c3a62be4...3b182a2b - 8 commits from branch develop
• 21fb3acc - ENH: update handling of versioning and make control (issue #1010 (closed))

Compare with previous version

unmarked as a Work In Progress

changed the description

added 1 commit

• f17551e5 - ENH: update handling of versioning and make control (issue #1010 (closed))

Compare with previous version

added 2 commits

• c8488f69 - 1 commit from branch develop
• 1179bfa6 - ENH: update handling of versioning and make control (issue #1010 (closed))

Compare with previous version

added 5 commits

• 1179bfa6...44bc9cab - 4 commits from branch develop
• f21af7ac - ENH: update handling of versioning and make control (issue #1010 (closed))

Compare with previous version

@Pawan and @Prashant for some more testing.

added 4 commits

• f21af7ac...99505b84 - 3 commits from branch develop
• 55b81cb0 - ENH: update handling of versioning and make control (issue #1010 (closed))

Compare with previous version

added 8 commits

• 55b81cb0...a42236c5 - 7 commits from branch develop
• f308aa61 - ENH: update handling of versioning and make control (issue #1010 (closed))

Compare with previous version

Looks good. Please merge for further checking.

@andy - shall I merge or you?

merged

mentioned in commit 7384152e

• $WM_THIRD_PARTY_DIR environment variable seems empty for csh users. It prints "No ThirdParty directory found - skipping".

mentioned in commit d92964ac