MantisBT - CMake
View Issue Details
IDProjectCategoryView StatusDate SubmittedLast Update
0015517CMakeDocumentationpublic2015-04-16 11:012015-11-02 09:13
Reporterlegalize 
Assigned To 
PrioritynormalSeverityminorReproducibilityalways
StatusclosedResolutionduplicate 
PlatformAllOSAllOS VersionAll
Product VersionCMake 3.2.2 
Target VersionFixed in Version 
Summary0015517: documentation should give introducing version
DescriptionWhen writing a CMakeLists.txt, I might be using commands that are beyond the minimum required version written in the CMakeLists.txt, but not realize it because I have a later version than the required version installed.

I ran into this because I had CMake 2.8.10.2 installed, with a CMakeLists.txt that said cmake_minimum_required(VERSION 2.8) and used target_include_directories which isn't an available command in version 2.8.10.2. So I looked at the documentation for the command, but it doesn't say in which version the command was introduced. If I knew the minimum version of CMake containing this command, then I could adjust the CMakeLists.txt to specify the true minimum required. Even better would be if this information were available in machine-readable format, then I could write a 'lint' tool for my CMakeLists.txt that would flag this as an error when my minimum version is too low for the commands I'm using.
Steps To Reproduce
Additional Information
TagsNo tags attached.
Relationships
duplicate of 0015222closed Kitware Robot Need a way to determine when features were introduced into cmake 
Attached Files
Issue History
Date ModifiedUsernameFieldChange
2015-04-16 11:01legalizeNew Issue
2015-04-16 11:29Nils GladitzNote Added: 0038533
2015-04-16 12:29legalizeNote Added: 0038534
2015-04-16 12:31Brad KingRelationship addedduplicate of 0015222
2015-04-16 12:32Brad KingStatusnew => resolved
2015-04-16 12:32Brad KingResolutionopen => duplicate
2015-11-02 09:13Robert MaynardNote Added: 0039776
2015-11-02 09:13Robert MaynardStatusresolved => closed

Notes
(0038533)
Nils Gladitz   
2015-04-16 11:29   
Instead of looking at the documentation of the cmake version that you happen to have installed you could look at the documentation that matches the version that you develop for.

The documentation in different versions is available on cmake.org.
For 2.8.0 that would be e.g. http://www.cmake.org/cmake/help/v2.8.0/cmake.html [^]
(0038534)
legalize   
2015-04-16 12:29   
While that may make sense to someone who develops CMake itself, I'm afraid that most of us mere mortals simply google for the commands or do cmake --help-commands, etc. It really would solve lots of subtle issues if the version introduced were explicitly listed for each command. I know that's a lot of fiddly documentation work, but it's a matter of usability.
(0039776)
Robert Maynard   
2015-11-02 09:13   
Closing resolved issues that have not been updated in more than 4 months.