mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-04 04:40:56 -06:00
fcbc883fa3
Adds the ``--project-file`` command-line option to modify the default script name loaded by CMake and ``add_subdirectory`` to values other than ``CMakeLists.txt``. Fixes: #21570
24 lines
862 B
ReStructuredText
24 lines
862 B
ReStructuredText
CMAKE_LIST_FILE_NAME
|
|
--------------------
|
|
|
|
.. versionadded:: 3.32
|
|
|
|
The name of the CMake project files. This determines the top-level file
|
|
processed when CMake is configured, and the file processed by
|
|
:command:`add_subdirectory`.
|
|
|
|
By default, this is ``CMakeLists.txt``. If set to anything else,
|
|
``CMakeLists.txt`` will be used as a fallback whenever the specified file
|
|
cannot be found within a project subdirectory.
|
|
|
|
This variable reports the value set via the :option:`cmake --project-file`
|
|
option. The value of this variable should never be set directly by projects or
|
|
users.
|
|
|
|
.. warning::
|
|
|
|
The use of alternate project file names is intended for temporary use by
|
|
developers during an incremental transition and not for publication of a final
|
|
product. CMake will always emit a warning when the project file is anything
|
|
other than ``CMakeLists.txt``.
|