MantisBT - CMake
View Issue Details
IDProjectCategoryView StatusDate SubmittedLast Update
0012373CMakeDocumentationpublic2011-07-31 06:132016-06-10 14:31
ReporterJérôme Vizcaino 
Assigned ToKitware Robot 
PrioritynormalSeveritymajorReproducibilityalways
StatusclosedResolutionmoved 
PlatformOSOS Version
Product VersionCMake-2-8 
Target VersionCMake 2.8.12Fixed in Version 
Summary0012373: Specify version changes with each commands/variables
DescriptionDocumentation is pretty efficient but if you work with different CMake versions, you almost always end up using a feature or a variable that was not available in previous versions (eg. 2.8.4 against 2.8.2, I'm not talking about 2.6 to 2.8 step)

New commands, variables, or command parameters are often added between versions. When this happens it would be nice to have it written in the doc so that users know not to use a specific feature when they are targeting a specific cmake version.

Thank you
Steps To Reproduce
Additional Information
TagsNo tags attached.
Relationships
Attached Files
Issue History
Date ModifiedUsernameFieldChange
2011-07-31 06:13Jérôme VizcainoNew Issue
2011-07-31 14:32Eric NOULARDNote Added: 0027132
2011-07-31 14:58Jérôme VizcainoNote Added: 0027133
2012-08-11 11:38David ColeStatusnew => backlog
2012-08-11 11:38David ColeNote Added: 0030288
2012-08-14 11:23David ColeStatusbacklog => new
2012-08-14 11:23David ColeTarget Version => CMake 2.8.10
2012-08-14 11:43Brad KingNote Added: 0030645
2012-10-18 11:16David ColeTarget VersionCMake 2.8.10 => CMake 2.8.11
2012-10-18 11:17David ColeNote Added: 0031265
2013-05-17 09:33Robert MaynardTarget VersionCMake 2.8.11 => CMake 2.8.12
2016-06-10 14:28Kitware RobotNote Added: 0041876
2016-06-10 14:28Kitware RobotStatusnew => resolved
2016-06-10 14:28Kitware RobotResolutionopen => moved
2016-06-10 14:28Kitware RobotAssigned To => Kitware Robot
2016-06-10 14:31Kitware RobotStatusresolved => closed

Notes
(0027132)
Eric NOULARD   
2011-07-31 14:32   
There is a nice Wiki page for that:
http://www.cmake.org/Wiki/CMake_Version_Compatibility_Matrix [^]

but it would definitely be interesting to have a "since x.y" inside the doc.
(0027133)
Jérôme Vizcaino   
2011-07-31 14:58   
That is right. I work at a place with no internet connection and the only thing I have is the manual (this is a Debian package).
Unless the Debian guys package the wiki, I'm stuck :)
(0030288)
David Cole   
2012-08-11 11:38   
Sending old, never assigned issues to the backlog.

(The age of the bug, plus the fact that it's never been assigned to anyone means that nobody is actively working on it...)

If an issue you care about is sent to the backlog when you feel it should have been addressed in a different manner, please bring it up on the CMake mailing list for discussion. Sign up for the mailing list here, if you're not already on it: http://www.cmake.org/mailman/listinfo/cmake [^]

It's easy to re-activate a bug here if you can find a CMake developer who has the bandwidth to take it on, and ferry a fix through to our 'next' branch for dashboard testing.
(0030645)
Brad King   
2012-08-14 11:43   
IMO having to specify the version in which every little thing was changed/added will be a huge maintenance burden. The information will accumulate and clutter the documentation with version references that become less useful over time.

Since this was first filed we've started posting documentation for each version separately on the web site:

 http://www.cmake.org/cmake/help/documentation.html [^]

For example:

 http://www.cmake.org/cmake/help/v2.8.0/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.1/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.2/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.3/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.4/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.5/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.6/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.7/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.8/cmake.html [^]
 http://www.cmake.org/cmake/help/v2.8.9/cmake.html [^]

Just read the docs corresponding to your cmake_minimum_required(VERSION).

If you don't have net access then just install minimum version of CMake you require and don't use a newer version.
(0031265)
David Cole   
2012-10-18 11:17   
These bugs were deferred from target version 2.8.10 to 2.8.11 based on the responses to this email thread on the CMake developer's mailing list:

  http://public.kitware.com/pipermail/cmake-developers/2012-October/005434.html [^]
(0041876)
Kitware Robot   
2016-06-10 14:28   
Resolving issue as `moved`.

This issue tracker is no longer used. Further discussion of this issue may take place in the current CMake Issues page linked in the banner at the top of this page.