View Issue Details [ Jump to Notes ] [ Print ]
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.
TagsNo tags attached.
Attached Files

 Relationships
duplicate of 0015222closedKitware Robot Need a way to determine when features were introduced into cmake 

  Notes
(0038533)
Nils Gladitz (developer)
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 (reporter)
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 (manager)
2015-11-02 09:13

 Closing resolved issues that have not been updated in more than 4 months.

 Issue History
Date Modified Username Field Change
2015-04-16 11:01 legalize New Issue
2015-04-16 11:29 Nils Gladitz Note Added: 0038533
2015-04-16 12:29 legalize Note Added: 0038534
2015-04-16 12:31 Brad King Relationship added duplicate of 0015222
2015-04-16 12:32 Brad King Status new => resolved
2015-04-16 12:32 Brad King Resolution open => duplicate
2015-11-02 09:13 Robert Maynard Note Added: 0039776
2015-11-02 09:13 Robert Maynard Status resolved => closed

Copyright © 2000 - 2018 MantisBT Team