1CMP0002
2-------
3
4Logical target names must be globally unique.
5
6Targets names created with :command:`add_executable`, :command:`add_library`, or
7:command:`add_custom_target` are logical build target names.  Logical target
8names must be globally unique because:
9
10::
11
12  - Unique names may be referenced unambiguously both in CMake
13    code and on make tool command lines.
14  - Logical names are used by Xcode and VS IDE generators
15    to produce meaningful project names for the targets.
16
17The logical name of executable and library targets does not have to
18correspond to the physical file names built.  Consider using the
19:prop_tgt:`OUTPUT_NAME` target property to create two targets with the same
20physical name while keeping logical names distinct.  Custom targets
21must simply have globally unique names (unless one uses the global
22property :prop_gbl:`ALLOW_DUPLICATE_CUSTOM_TARGETS` with a Makefiles generator).
23
24This policy was introduced in CMake version 2.6.0.  CMake version
25|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
26the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
27
28.. include:: DEPRECATED.txt
29