summaryrefslogtreecommitdiffstats
path: root/Help/prop_gbl
diff options
context:
space:
mode:
authorJuan Ramos <cmake@jpr.mozmail.com>2022-11-06 22:52:42 (GMT)
committerBrad King <brad.king@kitware.com>2022-11-08 14:32:18 (GMT)
commitd3acd22380663bd4061abf07384d507c589d3286 (patch)
treed56d36f61646b251a909a2feba9f6954b8e6f3f6 /Help/prop_gbl
parent3ee1017ce66d86190460d5c842324ea2a4870ae3 (diff)
downloadCMake-d3acd22380663bd4061abf07384d507c589d3286.zip
CMake-d3acd22380663bd4061abf07384d507c589d3286.tar.gz
CMake-d3acd22380663bd4061abf07384d507c589d3286.tar.bz2
USE_FOLDERS: Treat as on by default
Add a policy to treat the `USE_FOLDERS` global property as ON by default if it is not set. Fixes: #21695
Diffstat (limited to 'Help/prop_gbl')
-rw-r--r--Help/prop_gbl/USE_FOLDERS.rst15
1 files changed, 12 insertions, 3 deletions
diff --git a/Help/prop_gbl/USE_FOLDERS.rst b/Help/prop_gbl/USE_FOLDERS.rst
index 5919723..965b5d6 100644
--- a/Help/prop_gbl/USE_FOLDERS.rst
+++ b/Help/prop_gbl/USE_FOLDERS.rst
@@ -4,7 +4,16 @@ USE_FOLDERS
Use the :prop_tgt:`FOLDER` target property to organize targets into
folders.
-If not set, CMake treats this property as ``OFF`` by default. CMake
-generators that are capable of organizing into a hierarchy of folders
+.. versionchanged:: 3.26
+
+ CMake treats this property as ``ON`` by default.
+ See policy :policy:`CMP0143`.
+
+CMake generators that are capable of organizing into a hierarchy of folders
use the values of the :prop_tgt:`FOLDER` target property to name those
-folders. See also the documentation for the :prop_tgt:`FOLDER` target property.
+folders. (i.e.: Visual Studio / XCode)
+
+IDE's can also take advantage of this property to organize CMake targets.
+Regardless of generator support.
+
+See also the documentation for the :prop_tgt:`FOLDER` target property.