Skip to content
  • David Cole's avatar
    Add CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS_NO_WARNINGS variable · fa4a3b04
    David Cole authored
    The parent commit added a warning message whenever a required file
    does not exist.
    
    As it turns out, the "required" files never exist when built with
    Visual Studio Express editions. Add a variable to suppress these
    warning messages because only packagers or naive includers of
    this file will care to see such warning messages.
    
    We want to warn about this condition by default so that people who
    are using InstallRequiredSystemLibraries without understanding it
    fully will have a chance of understanding why it's not working in
    the event of missing required files.
    
    But we also want to give projects the ability to suppress this warning
    (by "project's choice default") so that they can encourage users who
    are restricted to using an Express edition to build their project.
    
    Packagers should explicitly use...
    
      -DCMAKE_INSTALL_SYSTEM_RUNTIME_LIBS_NO_WARNINGS=OFF
    
    ...when building releases. That way, their release build process will warn
    them about any missing files, but only if their project CMakeLists files
    use a construct similar to CMake's:
    
      IF(NOT DEFINED CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS_NO_WARNINGS)
        SET(CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS_NO_WARNINGS ON)
      ENDIF()
    fa4a3b04