Document when modules were added to ECM.

33 files changed, 70 insertions, 0 deletions

diff --git a/find-modules/FindEGL.cmake b/find-modules/FindEGL.cmake
index 99d268df..b96f3b0f 100644
--- a/find-modules/FindEGL.cmake
+++ b/find-modules/FindEGL.cmake
@@ -29,6 +29,8 @@
 # In general we recommend using the imported target, as it is easier to use.
 # Bear in mind, however, that if the target is in the link interface of an
 # exported library, it must be made available by the package config file.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/find-modules/FindKF5.cmake b/find-modules/FindKF5.cmake
index 2e1fca87..30b20948 100644
--- a/find-modules/FindKF5.cmake
+++ b/find-modules/FindKF5.cmake
@@ -16,6 +16,8 @@
 # If all the required components (those given in the COMPONENTS argument, but
 # not those given in the OPTIONAL_COMPONENTS argument) are found, ``KF5_FOUND``
 # will be set to true. Otherwise, it will be set to false.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/find-modules/FindLibGit2.cmake b/find-modules/FindLibGit2.cmake
index fd6f46ca..22fc5ebb 100644
--- a/find-modules/FindLibGit2.cmake
+++ b/find-modules/FindLibGit2.cmake
@@ -28,6 +28,8 @@
 # In general we recommend using the imported target, as it is easier to use.
 # Bear in mind, however, that if the target is in the link interface of an
 # exported library, it must be made available by the package config file.
+#
+# Since 1.3.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/find-modules/FindOpenEXR.cmake b/find-modules/FindOpenEXR.cmake
index 85afebdf..b63b8cd0 100644
--- a/find-modules/FindOpenEXR.cmake
+++ b/find-modules/FindOpenEXR.cmake
@@ -23,6 +23,8 @@
 # In general we recommend using the imported target, as it is easier to use.
 # Bear in mind, however, that if the target is in the link interface of an
 # exported library, it must be made available by the package config file.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2013-2014 Alex Merry <alex.merry@kdemail.net>
diff --git a/find-modules/FindPng2Ico.cmake b/find-modules/FindPng2Ico.cmake
index 71e2487c..7b201988 100644
--- a/find-modules/FindPng2Ico.cmake
+++ b/find-modules/FindPng2Ico.cmake
@@ -37,6 +37,7 @@
 #     while `Matthias Benkmann's tool
 #     <http://www.winterdrache.de/freeware/png2ico/>`_ does not.
 #
+# Since 1.7.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/find-modules/FindQtWaylandScanner.cmake b/find-modules/FindQtWaylandScanner.cmake
index 7fb8a009..28a4fda5 100644
--- a/find-modules/FindQtWaylandScanner.cmake
+++ b/find-modules/FindQtWaylandScanner.cmake
@@ -55,6 +55,8 @@
 # names don't start with ``qt_`` or ``wl_``.
 #
 # WaylandScanner is required and will be searched for.
+#
+# Since 1.4.0.
 
 #=============================================================================
 # Copyright 2012-2014 Pier Luigi Fiorini <pierluigi.fiorini@gmail.com>
diff --git a/find-modules/FindSharedMimeInfo.cmake b/find-modules/FindSharedMimeInfo.cmake
index 263a5028..ebbe3284 100644
--- a/find-modules/FindSharedMimeInfo.cmake
+++ b/find-modules/FindSharedMimeInfo.cmake
@@ -23,6 +23,8 @@
 # Updates the XDG mime database at install time (unless the ``$DESTDIR``
 # environment variable is set, in which case it is up to package managers to
 # perform this task).
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2013-2014 Alex Merry <alex.merry@kdemail.net>
diff --git a/find-modules/FindWayland.cmake b/find-modules/FindWayland.cmake
index 490ab1be..f69fa18b 100644
--- a/find-modules/FindWayland.cmake
+++ b/find-modules/FindWayland.cmake
@@ -44,6 +44,8 @@
 # and provide more control.  Bear in mind, however, that if any target is in the
 # link interface of an exported library, it must be made available by the
 # package config file.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/find-modules/FindWaylandScanner.cmake b/find-modules/FindWaylandScanner.cmake
index 33c46f9b..4052cdab 100644
--- a/find-modules/FindWaylandScanner.cmake
+++ b/find-modules/FindWaylandScanner.cmake
@@ -47,6 +47,8 @@
 # Generate Wayland server protocol files from ``<xmlfile>`` XML
 # definition for the ``<basename>`` interface and append those files
 # to ``<source_files_var>``.
+#
+# Since 1.4.0.
 
 #=============================================================================
 # Copyright 2012-2014 Pier Luigi Fiorini <pierluigi.fiorini@gmail.com>
diff --git a/find-modules/FindX11_XCB.cmake b/find-modules/FindX11_XCB.cmake
index eafa08e2..8b975e6a 100644
--- a/find-modules/FindX11_XCB.cmake
+++ b/find-modules/FindX11_XCB.cmake
@@ -30,6 +30,8 @@
 # In general we recommend using the imported target, as it is easier to use.
 # Bear in mind, however, that if the target is in the link interface of an
 # exported library, it must be made available by the package config file.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/find-modules/FindXCB.cmake b/find-modules/FindXCB.cmake
index 781b15c5..b2a800f7 100644
--- a/find-modules/FindXCB.cmake
+++ b/find-modules/FindXCB.cmake
@@ -51,6 +51,8 @@
 # and provide more control.  Bear in mind, however, that if any target is in the
 # link interface of an exported library, it must be made available by the
 # package config file.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2011 Fredrik Höglund <fredrik@kde.org>
diff --git a/kde-modules/KDECMakeSettings.cmake b/kde-modules/KDECMakeSettings.cmake
index 000761fb..0c997931 100644
--- a/kde-modules/KDECMakeSettings.cmake
+++ b/kde-modules/KDECMakeSettings.cmake
@@ -45,6 +45,10 @@
 # This section also provides an "uninstall" target that can be individually
 # disabled by setting ``KDE_SKIP_UNINSTALL_TARGET`` to TRUE before including
 # this module.
+#
+# Since pre-1.0.0.
+#
+# Uninstall target functionality since 1.7.0.
 
 #=============================================================================
 # Copyright 2014      Alex Merry <alex.merry@kde.org>
diff --git a/kde-modules/KDECompilerSettings.cmake b/kde-modules/KDECompilerSettings.cmake
index aa0249d9..5a585021 100644
--- a/kde-modules/KDECompilerSettings.cmake
+++ b/kde-modules/KDECompilerSettings.cmake
@@ -29,6 +29,8 @@
 #
 # Enables exceptions for C++ source files compiled for the
 # CMakeLists.txt file in the current directory and all subdirectories.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014      Alex Merry <alex.merry@kde.org>
diff --git a/kde-modules/KDEFrameworkCompilerSettings.cmake b/kde-modules/KDEFrameworkCompilerSettings.cmake
index 3b77fc3c..1bc23ccf 100644
--- a/kde-modules/KDEFrameworkCompilerSettings.cmake
+++ b/kde-modules/KDEFrameworkCompilerSettings.cmake
@@ -11,6 +11,8 @@
 # For example, constructions like QString("foo") are prohibited, instead
 # forcing the use of QLatin1String or QStringLiteral, and some
 # Qt-defined keywords like signals and slots will not be defined.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2013      Albert Astals Cid <aacid@kde.org>
diff --git a/kde-modules/KDEInstallDirs.cmake b/kde-modules/KDEInstallDirs.cmake
index a690ae9c..b7cd34d8 100644
--- a/kde-modules/KDEInstallDirs.cmake
+++ b/kde-modules/KDEInstallDirs.cmake
@@ -169,6 +169,11 @@
 # be used on the command line when possible (eg: use
 # ``-DKDE_INSTALL_LIBDIR=lib64`` instead of
 # ``-DKDE_INSTALL_LIBDIR=/usr/lib/lib64`` to override the library directory).
+#
+# Since pre-1.0.0.
+#
+# NB: The variables starting ``KDE_INSTALL_`` are only available since 1.6.0.
+# The ``APPDIR`` install variable is available since 1.1.0.
 
 #=============================================================================
 # Copyright 2014-2015 Alex Merry <alex.merry@kde.org>
diff --git a/modules/ECMAddAppIcon.cmake b/modules/ECMAddAppIcon.cmake
index 4efdd392..f90d4c33 100644
--- a/modules/ECMAddAppIcon.cmake
+++ b/modules/ECMAddAppIcon.cmake
@@ -42,6 +42,8 @@
 #      of the generated icns file, so that it will be used as the
 #      ``MACOSX_BUNDLE_ICON_FILE`` target property when you call
 #      ``add_executable``.
+#
+# Since 1.7.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/modules/ECMAddTests.cmake b/modules/ECMAddTests.cmake
index ed1e0f66..de06315d 100644
--- a/modules/ECMAddTests.cmake
+++ b/modules/ECMAddTests.cmake
@@ -36,6 +36,8 @@
 # This is a convenient version of ecm_add_test() for when you have many tests
 # that consist of a single source file each.  It behaves like calling
 # ecm_add_test() once for each source file, with the same named arguments.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2013 Alexander Richardson <arichardson.kde@gmail.com>
diff --git a/modules/ECMCoverageOption.cmake b/modules/ECMCoverageOption.cmake
index 92fcf74d..4cfe6641 100644
--- a/modules/ECMCoverageOption.cmake
+++ b/modules/ECMCoverageOption.cmake
@@ -11,6 +11,8 @@
 #
 # If it's on, the project will be compiled with code coverage support, using
 # gcov. Otherwise, it will be built normally.
+#
+# Since 1.3.0.
 
 #=============================================================================
 # Copyright 2014 Aleix Pol Gonzalez <aleixpol@kde.org>
diff --git a/modules/ECMCreateQmFromPoFiles.cmake b/modules/ECMCreateQmFromPoFiles.cmake
index b66e5989..3f134fbb 100644
--- a/modules/ECMCreateQmFromPoFiles.cmake
+++ b/modules/ECMCreateQmFromPoFiles.cmake
@@ -68,6 +68,8 @@
 #
 # This generates a C++ file which loads "mylib.qm" at startup, assuming it has
 # been installed by ecm_create_qm_from_po_files(), and compiles it into ``mylib``.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Aurélien Gâteau <agateau@kde.org>
diff --git a/modules/ECMEnableSanitizers.cmake b/modules/ECMEnableSanitizers.cmake
index a0df80e2..568fa397 100644
--- a/modules/ECMEnableSanitizers.cmake
+++ b/modules/ECMEnableSanitizers.cmake
@@ -61,6 +61,8 @@
 # => Most of the sanitizers will require Clang. To enable it, use :
 # -DCMAKE_CXX_COMPILER=clang++
 #
+# Since 1.3.0.
+
 #=============================================================================
 # Copyright 2014 Mathieu Tarral <mathieu.tarral@gmail.com>
 #
diff --git a/modules/ECMFindModuleHelpers.cmake b/modules/ECMFindModuleHelpers.cmake
index 79bd6fb8..63cccb93 100644
--- a/modules/ECMFindModuleHelpers.cmake
+++ b/modules/ECMFindModuleHelpers.cmake
@@ -92,6 +92,8 @@
 # different components (typically because of multiple find_package() calls) then
 # ``<name>_TARGETS``, for example, will contain all the targets found in any
 # call (although no duplicates).
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/modules/ECMGenerateHeaders.cmake b/modules/ECMGenerateHeaders.cmake
index bac50869..5e5615b6 100644
--- a/modules/ECMGenerateHeaders.cmake
+++ b/modules/ECMGenerateHeaders.cmake
@@ -88,6 +88,8 @@
 #   install(FILES ${MyLib_HEADERS}
 #           DESTINATION ${CMAKE_INSTALL_PREFIX}/include/mylib
 #           COMPONENT Devel)
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2013 Aleix Pol Gonzalez <aleixpol@blue-systems.com>
diff --git a/modules/ECMGeneratePkgConfigFile.cmake b/modules/ECMGeneratePkgConfigFile.cmake
index eb0e385d..052dcb1e 100644
--- a/modules/ECMGeneratePkgConfigFile.cmake
+++ b/modules/ECMGeneratePkgConfigFile.cmake
@@ -59,6 +59,7 @@
 #       INSTALL
 #   )
 #
+# Since 1.3.0.
 
 #=============================================================================
 # Copyright 2014 Aleix Pol Gonzalez <aleixpol@kde.org>
diff --git a/modules/ECMGeneratePriFile.cmake b/modules/ECMGeneratePriFile.cmake
index 3a409723..af4b8771 100644
--- a/modules/ECMGeneratePriFile.cmake
+++ b/modules/ECMGeneratePriFile.cmake
@@ -68,6 +68,8 @@
 #   QT += KArchive
 #
 # in their ``.pro`` file.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 David Faure <faure@kde.org>
diff --git a/modules/ECMInstallIcons.cmake b/modules/ECMInstallIcons.cmake
index 19d44d36..34d5a485 100644
--- a/modules/ECMInstallIcons.cmake
+++ b/modules/ECMInstallIcons.cmake
@@ -59,6 +59,8 @@
 #
 # With this syntax, the file ``hi22-actions-menu_new.png`` would be installed
 # into ``<icon_install_dir>/hicolor/22x22/actions/menu_new.png``
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/modules/ECMMarkAsTest.cmake b/modules/ECMMarkAsTest.cmake
index 24b8cfc7..9027bf30 100644
--- a/modules/ECMMarkAsTest.cmake
+++ b/modules/ECMMarkAsTest.cmake
@@ -13,6 +13,8 @@
 #
 # BUILD_TESTING is created as a cache variable by the CTest module and by the
 # :kde-module:`KDECMakeSettings` module.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2012 Stephen Kelly <steveire@gmail.com>
diff --git a/modules/ECMMarkNonGuiExecutable.cmake b/modules/ECMMarkNonGuiExecutable.cmake
index 9b680216..59737d4c 100644
--- a/modules/ECMMarkNonGuiExecutable.cmake
+++ b/modules/ECMMarkNonGuiExecutable.cmake
@@ -11,6 +11,8 @@
 # This will indicate to CMake that the specified targets should not be included
 # in a MACOSX_BUNDLE and should not be WIN32_EXECUTABLEs.  On platforms other
 # than MacOS X or Windows, this will have no effect.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2012 Stephen Kelly <steveire@gmail.com>
diff --git a/modules/ECMOptionalAddSubdirectory.cmake b/modules/ECMOptionalAddSubdirectory.cmake
index 6cbafa2d..2b890055 100644
--- a/modules/ECMOptionalAddSubdirectory.cmake
+++ b/modules/ECMOptionalAddSubdirectory.cmake
@@ -24,6 +24,8 @@
 # .. code-block:: sh
 #
 #   cmake -DDISABLE_ALL_OPTIONAL_SUBDIRECTORIES=TRUE -DBUILD_foo=TRUE myproject
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2007 Alexander Neundorf <neundorf@kde.org>
diff --git a/modules/ECMPackageConfigHelpers.cmake b/modules/ECMPackageConfigHelpers.cmake
index bc99d1cb..6e69fb80 100644
--- a/modules/ECMPackageConfigHelpers.cmake
+++ b/modules/ECMPackageConfigHelpers.cmake
@@ -37,6 +37,8 @@
 # the find_dependency() macro (which you can include() in your package config
 # file), so this file is only useful for projects whose minimum required version
 # is 2.8.12.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kdemail.net>
diff --git a/modules/ECMPoQmTools.cmake b/modules/ECMPoQmTools.cmake
index 74dc6563..015b7f90 100644
--- a/modules/ECMPoQmTools.cmake
+++ b/modules/ECMPoQmTools.cmake
@@ -65,6 +65,8 @@
 # ``<install_destination>`` defaults to ``${LOCALE_INSTALL_DIR}`` if defined,
 # otherwise it uses ``${CMAKE_INSTALL_LOCALEDIR}`` if that is defined, otherwise
 # it uses ``share/locale``.
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2007-2009 Kitware, Inc.
diff --git a/modules/ECMSetupVersion.cmake b/modules/ECMSetupVersion.cmake
index b908f96e..33d0ada1 100644
--- a/modules/ECMSetupVersion.cmake
+++ b/modules/ECMSetupVersion.cmake
@@ -73,6 +73,9 @@
 # first argument.  In all other respects, it behaves like the other form of the
 # command.
 #
+# Since pre-1.0.0.
+#
+# COMPATIBLITY option available since 1.6.0.
 
 #=============================================================================
 # Copyright 2014 Alex Merry <alex.merry@kde.org>
diff --git a/modules/ECMUninstallTarget.cmake b/modules/ECMUninstallTarget.cmake
index d9363125..1e9bb91e 100644
--- a/modules/ECMUninstallTarget.cmake
+++ b/modules/ECMUninstallTarget.cmake
@@ -27,6 +27,8 @@
 #   CMake deliberately does not provide an ``uninstall`` target by default on
 #   the basis that such a target has the potential to remove important files
 #   from a user's computer. Use with caution.
+#
+# Since 1.7.0.
 
 #=============================================================================
 # Copyright 2015 Alex Merry <alex.merry@kde.org>
diff --git a/modules/ECMUseFindModules.cmake b/modules/ECMUseFindModules.cmake
index a48f599b..0a8a40fb 100644
--- a/modules/ECMUseFindModules.cmake
+++ b/modules/ECMUseFindModules.cmake
@@ -44,6 +44,8 @@
 # be installed along with config files if they are required as a dependency (for
 # example, if targets provided by the find module are in the link interface of a
 # library).
+#
+# Since pre-1.0.0.
 
 #=============================================================================
 # Copyright 2011 Alexander Neundorf <neundorf@kde.org>