CMake Version Compatibility Matrix

Compatibility across different CMake versions

Below you can find a list of features and when they were introduced to cmake. The features are grouped by their respective section in the documentation. Entries marked in green show available, fully upwards-compatible features. Entries in yellow mark changes in features that are available in higher versions of CMake, but not in this version. Entries in red mark incompatible changes or not available features.

Options

CMake Option	2.8.3	2.8.2	2.8.1	2.8.0	2.6-patch 4	2.6-patch 3	2.6-patch 2	2.6-patch 1	2.6-patch 0
-C <initial-cache>	X	X	X	X	X	X	X	X	X
-D <var>:<type>=<value>	X	X	X	X	X	X	X	X	X
-U <globbing_expr>	X	X	X	X	X	X	X	X	X
-G <generator-name>	X	X	X	X	X	X	X	X	X
-Wno-dev	X	X	X	X	X	X	X	X	X
-Wdev	X	X	X	X	X	X	X	X	X
-E	X	X	X	X	X	X	X	X	X
-i	X	X	X	X	X	X	X	X	X
-L[A][H]	X	X	X	X	X	X	X	X	X
--build <dir>	X	X	X	X	-	-	-	-	-
-N	X	X	X	X	X	X	X	X	X
-P <file>	X	X	X	X	X	X	X	X	X
--graphviz=[file]	X	X	X	X	X	X	X	X	X
--system-information [file]	X	X	X	X	X	X	X	X	X
--debug-trycompile	X	X	X	X	X	X	X	X	X
--debug-output	X	X	X	X	X	X	X	X	X
--trace	X	X	X	X	X	X	X	-	-
--help-command cmd [file]	X	X	X	X	X	X	X	X	X
--help-command-list [file]	X	X	X	X	X	X	X	X	X
--help-commands [file]	X	X	X	X	X	X	X	X	X
--help-compatcommands [file]	X	X	X	X	X	X	X	X	X
--help-module module [file]	X	X	X	X	X	X	X	X	X
--help-module-list [file]	X	X	X	X	X	X	X	X	X
--help-modules [file]	X	X	X	X	X	X	X	X	X
--help-custom-modules [file]	X	X	X	X	X	X	X	X	X
--help-policy cmp [file]	X	X	X	X	X	X	X	X	-
--help-policies [file]	X	X	X	X	X	X	X	X	-
--help-property prop [file]	X	X	X	X	X	X	X	X	X
--help-property-list [file]	X	X	X	X	X	X	X	X	X
--help-properties [file]	X	X	X	X	X	X	X	X	X
--help-variable var [file]	X	X	X	X	X	X	X	X	X
--help-variable-list [file]	X	X	X	X	X	X	X	X	X
--help-variables [file]	X	X	X	X	X	X	X	X	X
--copyright [file]	X	X	X	X	X	X	X	X	X
--help	X	X	X	X	X	X	X	X	X
--help-full [file]	X	X	X	X	X	X	X	X	X
--help-html [file]	X	X	X	X	X	X	X	X	X
--help-man [file]	X	X	X	X	X	X	X	X	X
--version [file]	X	X	X	X	X	X	X	X	X

Note: Commands available with the -E option are not tracked by this overview.

Commands

CMake Option	2.8.3	2.8.2	2.8.1	2.8.0	2.6-patch 4	2.6-patch 3	2.6-patch 2	2.6-patch 1	2.6-patch 0
add_custom_command	X	X	X	X	X	X	X	X	X
add_custom_target	X	X	X	X	X	X (missing: option SOURCES)	X	X	X
add_definitions	X	X	X	X	X	X	X	X	X
add_dependencies	X	X	X	X	X	X	X	X	X
add_executable	X	X	X	X	X	X	X	X	X
add_library	X	X	X	X	X	X	X	X (missing: add library type UNKNOWN)	X
add_subdirectory	X	X	X	X	X	X	X	X	X
add_test	X	X	X	X	X	-	X	X	X
aux_source_directory	X	X	X	X	X	X	X	X	X
break	X	X	X	X	X	X	X	X	X
build_command	X	X	X	X (missing: supports options CONFIGURATION, PROJECT_NAME, and TARGET)	X	X	X	X	X
cmake_minimum_required	X	X	X (missing: optional .tweak to version)	X	X	X	X	X	X
cmake_policy	X	X	X	X	X	X	X	X (missing: support GET)	X
configure_file	X	X	X (missing: DOWNLOAD supports options EXPECTED_MD5 and SHOW_PROGRESS)	X	X	X	X	X	X
create_test_sourcelist	X	X	X	X	X	X	X	X	X
define_property	X	X	X	X	X	X	X	X	X
else	X	X	X	X	X	X	X	X	X
elseif	X	X	X	X	X	X	X	X	X
enable_language	X	X	X	X	X	X	X	X	X
enable_testing	X	X	X	X	X	X	X	X	X
endforeach	X	X	X	X	X	X	X	X	X
endfunction	X	X	X	X	X	X	X	X	X
endif	X	X	X	X	X	X	X	X	X
endmacro	X	X	X	X	X	X	X	X	X
endwhile	X	X	X	X	X	X	X	X	X
execute_process	X	X	X	X	X	X	X	X	X
export	X	X	X	X	X (missing: PACKAGE)	X	X	X	X
file	X	X	X	X	X (missing: RENAME, COPY, INSTALL)	X	X	X (missing: GLOB_RECURSE supports FOLLOW_SYMLINKS)	X
find_file	X	X	X	X	X	X	X	X	X (missing: option HINTS)
find_library	X	X	X	X	X	X	X	X	X (missing: option HINTS)
find_package	X	X (missing: sets variable <package>_CONSIDERED_CONFIGS)	X	X (change: doesn't search in <package>_DIR when considering CMAKE_ENVIRONMENT_PATH)	X (missing: option NO_CMAKE_PACKAGE_REGISTRY)	X (missing: option NO_POLICY_SCOPE; change: don't continue, if <package>_DIR is set incorrectly; doesn't check PACKAGE_VERSION_UNSUITABLE; fewer search-paths)	X	X (missing: sets variable PACKAGE_FIND_VERSION_TWEAK and PACKAGE_FIND_VERSION_COUNT)	X (missing: option HINTS)
find_path	X	X	X	X	X	X	X	X	X (missing: option HINTS)
find_program	X	X	X	X	X	X	X	X	X (missing: option HINTS)
fltk_wrap_ui	X	X	X	X	X	X	X	X	X
foreach	X	X	X	X	X (missing: IN LISTS, IN ITEMS)	X	X	X	X
function	X	X	X	X	X	X	X	X	X
get_cmake_property	X	X	X	X	X	X	X	X	X
get_directory_property	X	X	X	X	X	X	X	X	X
get_filename_component	X	X	X	X	X	X (missing: option REALPATH)	X	X	X
get_property	X	X	X	X	X (missing: CACHE)	X	X	X	X
get_source_file_property	X	X	X	X	X	X	X	X	X
get_target_property	X	X	X	X	X	X	X	X	X
get_test_property	X	X	X	X	X	X	X	X	X
if	X	X	X	X (missing: IS_SYMLINK)	X (missing: allow constants, parenthesis)	X	X	X (missing: TARGET, VERSION_LESS, VERSION_EQUAL, VERSION_GREATER)	X
include	X	X	X	X	X	X (missing: option NO_POLICY_SCOPE)	X	X	X
include_directories	X	X	X	X	X	X	X	X	X
include_external_msproject	X	X	X (change: prefix created target with "INCLUDE_EXTERNAL_MSPROJECT_")	X	X	X	X	X	X
include_regular_expression	X	X	X	X	X	X	X	X	X
install	X	X	X	X	X (missing: DIRECTORY supports OPTIONAL)	X	X	X	X
link_directories	X	X	X	X	X	X	X	X	X
list	X	X	X	X	X	X	X	X	X
load_cache	X	X	X	X	X	X	X	X	X
load_command	X	X	X	X	X	X	X	X	X
macro	X	X	X	X	X	X	X	X	X
mark_as_advanced	X	X	X	X	X	X	X	X	X
math	X	X	X	X	X	X	X	X	X
message	X	X	X	X	X (missing: WARNING, AUTHOR_WARNING)	X	X	X	X
option	X	X	X	X	X	X	X	X	X
output_required_files	X	X	X	X	X	X	X	X	X
project	X	X	X	X	X	X (missing: custom languages supported)	X	X	X
qt_wrap_cpp	X	X	X	X	X	X	X	X	X
qt_wrap_ui	X	X	X	X	X	X	X	X	X
remove_definitions	X	X	X	X	X	X	X	X	X
return	X	X	X	X	X	X	X	X (missing: returns from file)	X
separate_arguments	X	X	X	X	X (missing: UNIX_COMMAND, WINDOWS_COMMAND)	X	X	X	X
set	X	X	X	X	X	X	X	X	X
set_directory_properties	X	X	X	X	X	X	X	X	X
set_property	X	X	X	X	X (missing: CACHE)	X	X	X	X
set_source_files_properties	X	X	X	X	X	X	X	X	X
set_target_properties	X	X	X	X	X	X (missing: support VS_SCC_PROJECTNAME, VS_SCC_LOCALPATH, VS_SCC_PROVIDER)	X	X	X
set_tests_properties	X	X	X	X	X	X	X	X	X
site_name	X	X	X	X	X	X	X	X	X
source_group	X	X	X	X	X	X	X	X	X
string	X	X	X	X	X (missing: RANDOM supports RANDOM_SEED)	X	X	X	X
target_link_libraries	X	X	X	X	X	X	X	X (missing: option LINK_INTERFACE_LIBRARIES)	X
try_compile	X	X	X	X	X	X	X	X	X
try_run	X	X	X	X	X	X	X	X	X
unset	X	X	X	X	X	X	-	-	-
variable_watch	X	X	X	X	X	X	X	X	X
while	X	X	X	X	X	X	X	X	X