You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
31 lines
1.1 KiB
31 lines
1.1 KiB
CMP0143
|
|
-------
|
|
|
|
.. versionadded:: 3.26
|
|
|
|
:prop_gbl:`USE_FOLDERS` global property is treated as ``ON`` by default.
|
|
|
|
When using CMake 3.25 or earlier, :prop_gbl:`USE_FOLDERS` is treated
|
|
as ``OFF`` by default unless projects enable the feature. For example:
|
|
|
|
.. code-block:: cmake
|
|
|
|
cmake_minimum_required(VERSION 3.25)
|
|
project(foobar LANGUAGES CXX)
|
|
set_property(GLOBAL PROPERTY USE_FOLDERS ON)
|
|
|
|
CMake 3.26 and later prefer to enable the feature by default.
|
|
|
|
Note that it is the policy setting at the `end` of the top level
|
|
``CMakeLists.txt`` file that matters. The policy setting applies globally
|
|
to the whole project.
|
|
|
|
This policy provides compatibility with projects that have not been updated
|
|
to expect enabling of folders. Enabling folders causes projects to appear
|
|
differently in IDEs. The policy was introduced in CMake version 3.26. Use the
|
|
:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
|
|
Unlike many policies, CMake version |release| does *not* warn
|
|
when this policy is not set and simply uses ``OLD`` behavior.
|
|
|
|
.. include:: DEPRECATED.txt
|