diff --git a/Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst b/Help/prop_tgt/XCODE_ATTRIBUTE_an-attribute.rst index 71858c50e5..fbe760815f 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 90e4c0eacc..ffa0a4c7a6 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.