CMAKE_ERROR_DEPRECATED

CMAKE_ERROR_DEPRECATED

.. deprecated:: 4.4

Whether to issue errors for deprecated functionality.

This is a deprecated mechanism for interacting with the :diagnostic:CMD_DEPRECATED :manual:diagnostic <cmake-diagnostics(7)>. If policy :policy:CMP0218 is set to NEW, this variable is ignored.

If policy :policy:CMP0218 is not set to NEW, the :command:message command's DEPRECATION message type will use :variable:CMAKE_WARN_DEPRECATED and CMAKE_ERROR_DEPRECATED to determine the severity of a deprecation diagnostic. The severity will be:

• IGNORE, if CMAKE_WARN_DEPRECATED is OFF and CMAKE_ERROR_DEPRECATED is unset or OFF.

• WARN, if CMAKE_WARN_DEPRECATED is unset or ON and CMAKE_ERROR_DEPRECATED is unset or OFF.

• FATAL_ERROR if CMAKE_ERROR_DEPRECATED is ON.

Setting CMAKE_ERROR_DEPRECATED in the cache will alter the default state of the :diagnostic:CMD_DEPRECATED :manual:diagnostic <cmake-diagnostics(7)>; however, the :option:-W[no-][error=]deprecated <cmake -W> option, and :preset:warnings.deprecated <configurePresets.warnings.deprecated> and/or :preset:errors.deprecated <configurePresets.errors.deprecated> preset fields, will take precedence. CMake will also update the cached value of CMAKE_ERROR_DEPRECATED to reflect the actual state of the diagnostic as of the start of script execution.