CMP0175ΒΆ
Added in version 3.31.
add_custom_command() rejects invalid arguments.
CMake 3.30 and earlier silently ignored unsupported keywords and missing or
invalid arguments for the different forms of the add_custom_command()
command. CMake 3.31 implements more rigorous argument checking and will flag
invalid or missing arguments as errors.
The OLD behavior of this policy will accept the same invalid keywords or
arguments as CMake 3.30 and earlier. The NEW behavior will flag the
following as errors that previously went unreported:
The
OUTPUTform does not acceptPRE_BUILD,PRE_LINK, orPOST_BUILDkeywords.When the
APPENDkeyword is given, theOUTPUTform also does not acceptBYPRODUCTS,COMMAND_EXPAND_LISTS,DEPENDS_EXPLICIT_ONLY,DEPFILE,JOB_POOL,JOB_SERVER_AWARE,USES_TERMINAL, orVERBATIMkeywords.The
TARGETform requires exactly one ofPRE_BUILD,PRE_LINK, orPOST_BUILDto be given. Previously, if none were given,POST_BUILDwas assumed, or if multiple keywords were given, the last one was used.The
TARGETform does not acceptDEPENDS,DEPENDS_EXPLICIT_ONLY,DEPFILE,IMPLICIT_DEPENDS,MAIN_DEPENDENCY,JOB_POOL, orJOB_SERVER_AWAREkeywords.The
TARGETform now requires at least oneCOMMANDto be given.If a keyword expects a value to be given after it, but no value is provided, that was previously treated as though the keyword was not given at all.
The
COMMENTkeyword expects exactly one value after it. If multiple values are given, or if theCOMMENTkeyword is given more than once, this is an error.
This policy was introduced in CMake version 3.31.
It may be set by cmake_policy() or cmake_minimum_required().
If it is not set, CMake warns, and uses OLD behavior.
Note
The OLD behavior of a policy is
deprecated by definition
and may be removed in a future version of CMake.