From 3c80666f00d94a762d768130cfa6adce6eb21487 Mon Sep 17 00:00:00 2001 From: Brad King Date: Thu, 21 Jan 2021 12:08:48 -0500 Subject: Help: Document intended purpose of XCODE_ATTRIBUTE_ Also warn the reader against setting values CMake normally generates. Issue: #21728 --- Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst | 8 +++++++- 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_ Set Xcode target attributes directly. -Tell the :generator:`Xcode` generator to set '' to a given +Tell the :generator:`Xcode` generator to set ```` 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_` 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_ Set Xcode target attributes directly. -Tell the :generator:`Xcode` generator to set '' to a given value -in the generated Xcode project. Ignored on other generators. +Tell the :generator:`Xcode` generator to set ```` 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_` target property to set attributes on a specific target. -- cgit v0.12