cmake/Help/prop_gbl/USE_FOLDERS.rst

18 lines
688 B
ReStructuredText
Raw Normal View History

2014-08-03 19:52:23 +02:00
USE_FOLDERS
-----------
2023-05-23 16:38:00 +02:00
Controls whether to use the :prop_tgt:`FOLDER` target property to organize
targets into folders. The value of ``USE_FOLDERS`` at the end of the top level
``CMakeLists.txt`` file is what determines the behavior.
2014-08-03 19:52:23 +02:00
2023-05-23 16:38:00 +02:00
.. versionchanged:: 3.26
CMake treats this property as ``ON`` by default.
See policy :policy:`CMP0143`.
Not all CMake generators support recording folder details for targets.
The :generator:`Xcode` and :ref:`Visual Studio <Visual Studio Generators>`
generators are examples of generators that do. Similarly, not all IDEs
support presenting targets using folder hierarchies, even if the CMake
generator used provides the necessary information.