ENH: Added script to help suppress warnings.

\author Hans J. Johnson
\date 2013-04-04
This script it to help identify regular epsression
patterns # for the CTEST_CUSTOM_WARNING_EXCEPTION
variable in a file like ${CMAKE_SOURCE_DIR}/CMake/CTestCustom.cmake.in
for the purpose of supressing irrelavant warnings.

It can be frustrating to find the correct regular
expressions that are needed to avoid a polluted
CDash submission

The intended usage paradigm is to do the following:
1. In a completely clean build directory, run cmake
   to your preferred settings
2. Run "make -j1 > CDASH_WARNING_LOGGER 2>&1" to make a
   static log of all the warning messages that
   you want to suppress
3. Modify the suppressions file used by this build system
   that is usually in ${CMAKE_SOURCE_DIR}/CMake/CTestCustom.cmake.in
4. python FindCTestMatchingWarnings.py CDASH_WARNING_LOGGER ${CMAKE_SOURCE_DIR}/CMake/CTestCustom.cmake.in
5. Review output from (4), if suppressable warnings
   identified, return to (3), else goto (6)
6. CELEBRATE AN UNSULLIED DASHBOARD!

USAGE BRAINSTools/Utilities/FindCTestMatchingWarnings.py <CDASH_WARNING_LOGGER> <$CMAKE_SOURCE_DIR/CMake/CTestCustom.cmake.in>