summaryrefslogtreecommitdiffstats
path: root/Help/prop_gbl/USE_FOLDERS.rst
blob: 6f5a083fbcaeb73324209438958d69dacae42a56 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
USE_FOLDERS
-----------

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.

.. 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.