summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBartosz Kosiorek <bartosz.kosiorek@tomtom.com>2019-04-19 08:44:41 (GMT)
committerBartosz Kosiorek <bartosz.kosiorek@tomtom.com>2019-05-06 08:58:10 (GMT)
commit1527defbfe4ae9cb8f74d5954c790c403727063b (patch)
tree8c69a42200ac071bb693935dc67e121dd6497dc6 /Help
parent0f27e7d165c96f2c3ada1695df4f6cfaa44afe51 (diff)
downloadCMake-1527defbfe4ae9cb8f74d5954c790c403727063b.zip
CMake-1527defbfe4ae9cb8f74d5954c790c403727063b.tar.gz
CMake-1527defbfe4ae9cb8f74d5954c790c403727063b.tar.bz2
cmMakefile: Enforce explicit use of project() command
Fixes: 17714
Diffstat (limited to 'Help')
-rw-r--r--Help/command/project.rst15
1 files changed, 8 insertions, 7 deletions
diff --git a/Help/command/project.rst b/Help/command/project.rst
index 7e33ccd..41e1112 100644
--- a/Help/command/project.rst
+++ b/Help/command/project.rst
@@ -112,12 +112,13 @@ Usage
The top-level ``CMakeLists.txt`` file for a project must contain a
literal, direct call to the :command:`project` command; loading one
through the :command:`include` command is not sufficient. If no such
-call exists CMake will implicitly add one to the top that enables the
-default languages (``C`` and ``CXX``).
+call exists, CMake will issue a warning and pretend there is a
+``project(Project)`` at the top to enable the default languages
+(``C`` and ``CXX``).
.. note::
- Call the :command:`cmake_minimum_required` command at the beginning
- of the top-level ``CMakeLists.txt`` file even before calling the
- :command:`project()` command. It is important to establish version and
- policy settings before invoking other commands whose behavior they
- may affect. See also policy :policy:`CMP0000`.
+ Call the :command:`project()` command near the top of the top-level
+ ``CMakeLists.txt``, but *after* calling :command:`cmake_minimum_required`.
+ It is important to establish version and policy settings before invoking
+ other commands whose behavior they may affect.
+ See also policy :policy:`CMP0000`.