[Smtk-developers] New superbuild layout

[Ben Boeckel]

Hi,

As some of you have noticed, the superbuild build tree layout has
changed a bit. The new setup is (using zlib as an example):

    superbuild/zlib/src/zlib       -> superbuild/zlib/src
    superbuild/zlib/src/zlib-build -> superbuild/zlib/build
    superbuild/zlib/src/zlib-stamp -> superbuild/zlib/stamp

The easiest way to address any issues you see is to just delete the
install/ directory. The more surgical fix is to delete Python bits from
the install/ tree (it's the only one I saw which got headers mixed up,
but other projects may have similar problems).

As a reminder, do not do development underneath the superbuild unless
you know what you're doing[1]: the superbuild assumes it has full
control of the $builddir/superbuild directory. For SMTK and CMB, the
`SMTK_SOURCE_DIR` and `CMB_SOURCE_DIR` variables may be used by setting
`smtk_FROM_GIT=OFF` and `smtk_FROM_SOURCE_DIR=ON` (similar for CMB) so
that you can use the superbuild for arbitrary branches. Open issues if
other projects need similar treatment on a regular basis.

--Ben

[1]In particular, changing the source URL for git repos or the tarball
for non-git sources (or switching between the two) will remove the
corresponding source tree without asking.