diff options
author | Brad King <brad.king@kitware.com> | 2015-04-29 12:42:10 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2015-04-29 12:49:59 (GMT) |
commit | 6ac3712da0f1e90884a27d9c03974260f42d04f7 (patch) | |
tree | 2d4aa00656077f278e7c4639c633c1342a7acf5e /Help/command/cmake_minimum_required.rst | |
parent | f0673c1022afdc9f9d91ea460efc6790b7aa6289 (diff) | |
download | CMake-6ac3712da0f1e90884a27d9c03974260f42d04f7.zip CMake-6ac3712da0f1e90884a27d9c03974260f42d04f7.tar.gz CMake-6ac3712da0f1e90884a27d9c03974260f42d04f7.tar.bz2 |
Help: Document that cmake_minimum_required should be called first
Many projects put their project() call first, but the actions taken
by this command can be influenced by policies and other information
set by a call to cmake_minimum_required. Document in each of these
two commands that cmake_minimum_required should be called first.
Suggested-by: Alan W. Irwin
Diffstat (limited to 'Help/command/cmake_minimum_required.rst')
-rw-r--r-- | Help/command/cmake_minimum_required.rst | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/Help/command/cmake_minimum_required.rst b/Help/command/cmake_minimum_required.rst index 1bdffa4..92e3001 100644 --- a/Help/command/cmake_minimum_required.rst +++ b/Help/command/cmake_minimum_required.rst @@ -28,3 +28,10 @@ which enables compatibility features for CMake 2.4 and lower. The FATAL_ERROR option is accepted but ignored by CMake 2.6 and higher. It should be specified so CMake versions 2.4 and lower fail with an error instead of just a warning. + +.. note:: + Call the ``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`. |