mirror of
https://github.com/reactos/CMake.git
synced 2024-12-14 15:19:39 +00:00
482a3bf3f0
The most likely documentation page a project author will read in response to a policy warning is the page for the policy itself. Add to every policy documentation page a note explicitly stating that the OLD behavior is deprecated. Also mention this in the cmake_policy() command documentation that explains how to set a policy to OLD. Suggested-by: Fraser Hutchison <fraser.hutchison@gmail.com>
29 lines
1.1 KiB
ReStructuredText
29 lines
1.1 KiB
ReStructuredText
CMP0002
|
|
-------
|
|
|
|
Logical target names must be globally unique.
|
|
|
|
Targets names created with add_executable, add_library, or
|
|
add_custom_target are logical build target names. Logical target
|
|
names must be globally unique because:
|
|
|
|
::
|
|
|
|
- Unique names may be referenced unambiguously both in CMake
|
|
code and on make tool command lines.
|
|
- Logical names are used by Xcode and VS IDE generators
|
|
to produce meaningful project names for the targets.
|
|
|
|
The logical name of executable and library targets does not have to
|
|
correspond to the physical file names built. Consider using the
|
|
OUTPUT_NAME target property to create two targets with the same
|
|
physical name while keeping logical names distinct. Custom targets
|
|
must simply have globally unique names (unless one uses the global
|
|
property ALLOW_DUPLICATE_CUSTOM_TARGETS with a Makefiles generator).
|
|
|
|
This policy was introduced in CMake version 2.6.0. CMake version
|
|
|release| warns when the policy is not set and uses OLD behavior. Use
|
|
the cmake_policy command to set it to OLD or NEW explicitly.
|
|
|
|
.. include:: DEPRECATED.txt
|