<div dir="ltr">In my case, I work with a large code base that spans many projects with various interdependencies. Some of that code base is quite old and would benefit from updating to more modern CMake features, but some parts of the code I'm not free to update. For these cases, I need to understand what CMake version a particular feature was introduced before I can start using it and also to put in place guards so that the updated project can still be used with older projects that don't want or can't yet move to using a newer CMake version. In an ideal world, everyone would just move to the latest current CMake release and our projects could use whatever CMake features they like, but that's not the reality we live in, for various reasons. ;)<div><br></div><div>On a personal level, I also write a blog which frequently covers CMake features. I find I am always having to go check what version a particular CMake feature was introduced so that I can highlight to my readers what minimum CMake version they need to set. Like Vladimir, this usually requires me to go through release notes or older versions of the CMake docs to work out when that particular command, variable, module, etc. was added. It would be great if the latest version's documentation always had that information instead, it would be more reliable and certainly more convenient.<br><div><br></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Apr 25, 2016 at 11:48 PM, Nils Gladitz <span dir="ltr"><<a href="mailto:nilsgladitz@gmail.com" target="_blank">nilsgladitz@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
  
    
  
  <div bgcolor="#FFFFFF" text="#000000">
    On 04/25/2016 02:29 PM, Craig Scott wrote:<br>
    <blockquote type="cite"><font size="2"><span style="background-color:rgba(255,255,255,0)">I personally have
          found myself having to look up to his sort of version info a
          lot lately. It sounds like others do too. </span></font>Perhaps a
      more sustainable approach would be to include the version
      details in the CMAKE docs themselves. For each command, module,
      variable, etc. it's documentation could state the version it was
      added. Some may warrant further info for version(s) where
      significant changes were made (eg keywords added to a command).
      Realistically, it would have to be done progressively and
      obviously with agreement from the Kitware side. It would only work
      if it became part of the change process whereby any new features
      or changes must include such version details. It would be
      interesting to hear what Kitware think of the idea. Any chance?<br>
    </blockquote>
    <br>
    I've also made use of such information from time to time but I think
    it has been the exception and it doesn't normally come up during my
    regular development workflow.<br>
    <br>
    I assume for most projects there is a single
    cmake_minimum_required(VERSION).<br>
    Which means to see what is and what isn't available I only have to
    check that specific version's documentation.<br>
    <br>
    I am curious as to what kind of use case results in having to
    require cross-version information as provided by the compatibility
    matrix "a lot".<span class="HOEnZb"><font color="#888888"><br>
    <br>
    Nils<br>
  </font></span></div>

</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr">Craig Scott<br><div>Melbourne, Australia</div><div><a href="http://crascit.com" target="_blank">http://crascit.com</a><br></div></div></div></div></div>
</div>