Back to Cmake

CMAKE_LIST_FILE_NAME

Help/variable/CMAKE_LIST_FILE_NAME.rst

4.3.2859 B
Original Source

CMAKE_LIST_FILE_NAME

.. versionadded:: 4.0

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.