diff options
| author | Craig Scott <craig.scott@crascit.com> | 2021-01-24 08:26:27 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2021-01-24 08:26:35 (GMT) |
| commit | 72974fe3392630c3df7805c9ec641898b7dd128b (patch) | |
| tree | 271c7e8a378c461dc68bd05b05407973b87ad645 /Help | |
| parent | 1bfe5102b2a7f5bbd7fd86c562f9703879ffd84e (diff) | |
| parent | 3c80666f00d94a762d768130cfa6adce6eb21487 (diff) | |
| download | CMake-72974fe3392630c3df7805c9ec641898b7dd128b.zip CMake-72974fe3392630c3df7805c9ec641898b7dd128b.tar.gz CMake-72974fe3392630c3df7805c9ec641898b7dd128b.tar.bz2 | |
Merge topic 'doc-xcode-attr'
3c80666f00 Help: Document intended purpose of XCODE_ATTRIBUTE_<an-attribute>
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !5726
Diffstat (limited to 'Help')
| -rw-r--r-- | Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst | 8 | ||||
| -rw-r--r-- | Help/variable/CMAKE_XCODE_ATTRIBUTE_an-attribute.rst | 10 |
2 files changed, 15 insertions, 3 deletions
diff --git a/Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst b/Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst index 71858c5..fbe7608 100644 --- a/Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst +++ b/Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst @@ -3,9 +3,15 @@ XCODE_ATTRIBUTE_<an-attribute> Set Xcode target attributes directly. -Tell the :generator:`Xcode` generator to set '<an-attribute>' to a given +Tell the :generator:`Xcode` generator to set ``<an-attribute>`` to a given value in the generated Xcode project. Ignored on other generators. +This offers low-level control over the generated Xcode project file. +It is meant as a last resort for specifying settings that CMake does +not otherwise have a way to control. Although this can override a +setting CMake normally produces on its own, doing so bypasses CMake's +model of the project and can break things. + See the :variable:`CMAKE_XCODE_ATTRIBUTE_<an-attribute>` variable to set attributes on all targets in a directory tree. diff --git a/Help/variable/CMAKE_XCODE_ATTRIBUTE_an-attribute.rst b/Help/variable/CMAKE_XCODE_ATTRIBUTE_an-attribute.rst index 90e4c0e..ffa0a4c 100644 --- a/Help/variable/CMAKE_XCODE_ATTRIBUTE_an-attribute.rst +++ b/Help/variable/CMAKE_XCODE_ATTRIBUTE_an-attribute.rst @@ -5,8 +5,14 @@ CMAKE_XCODE_ATTRIBUTE_<an-attribute> Set Xcode target attributes directly. -Tell the :generator:`Xcode` generator to set '<an-attribute>' to a given value -in the generated Xcode project. Ignored on other generators. +Tell the :generator:`Xcode` generator to set ``<an-attribute>`` to a given +value in the generated Xcode project. Ignored on other generators. + +This offers low-level control over the generated Xcode project file. +It is meant as a last resort for specifying settings that CMake does +not otherwise have a way to control. Although this can override a +setting CMake normally produces on its own, doing so bypasses CMake's +model of the project and can break things. See the :prop_tgt:`XCODE_ATTRIBUTE_<an-attribute>` target property to set attributes on a specific target. |