summaryrefslogtreecommitdiffstats
path: root/Help/command/cmake_minimum_required.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-04-29 12:42:10 (GMT)
committerBrad King <brad.king@kitware.com>2015-04-29 12:49:59 (GMT)
commit6ac3712da0f1e90884a27d9c03974260f42d04f7 (patch)
tree2d4aa00656077f278e7c4639c633c1342a7acf5e /Help/command/cmake_minimum_required.rst
parentf0673c1022afdc9f9d91ea460efc6790b7aa6289 (diff)
downloadCMake-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.rst7
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`.