mirror of
https://github.com/Detanup01/gbe_fork.git
synced 2024-12-02 23:35:37 +08:00
31 lines
1.1 KiB
ReStructuredText
31 lines
1.1 KiB
ReStructuredText
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
|