mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-13 02:29:02 -06:00
ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
32 lines
962 B
ReStructuredText
32 lines
962 B
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.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.26
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|