Add ALLOW_BUILD_FAIL option to add_cmake_build_test.

Sometimes we want to ensure that a build fails, so add a new option
to allow that to happen and then check for it later in the
Verify stage.
Merge pull request #25 from smspillaz/cmake-unit.item_23

Add ALLOW_BUILD_FAIL option to add_cmake_build_test.