From 674f9cdaced97d003600e4a851a325bf4afe9383 Mon Sep 17 00:00:00 2001 From: Alexander Krabler Date: Tue, 8 Jul 2025 11:48:07 +0200 Subject: [PATCH] Fix and clarify description of self.folders.subproject The old documentation was wrong, as the subproject is not required to be the folder, where the `conanfile.py` is located. An example, where this is not the case, can be found here: https://docs.conan.io/2/examples/conanfile/layout/conanfile_in_subfolder.html --- reference/conanfile/methods/layout.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/reference/conanfile/methods/layout.rst b/reference/conanfile/methods/layout.rst index a1957bbab273..152cca7685f7 100644 --- a/reference/conanfile/methods/layout.rst +++ b/reference/conanfile/methods/layout.rst @@ -39,8 +39,9 @@ self.folders **self.folders.root**. - **self.folders.subproject** (Defaulted to ``None``): Specifies a subfolder where the - ``conanfile.py`` is relative to the project root. This is particularly useful for - :ref:`layouts with multiple subprojects` + project is contained relative to ``self.folders.root``. This is particularly useful for + :ref:`layouts with multiple subprojects`. + Most of the layout (e.g. source and build folder) is relocated inside this folder. - **self.folders.build_folder_vars** (Defaulted to ``None``): Use settings, options and/or ``self.name`` and ``self.version`` to produce a different build folder and different CMake presets names.