Merge topic 'deprecation'

c8e8c9cc7c Help: Date deprecation of deprecated commands.
19998d7b3c Help: Use 'deprecated' template, and date deprecation of modules
dc1bb33578 Help: Add version number to deprecation note

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2523

10 files changed, 42 insertions, 30 deletions

diff --git a/Modules/CMakeDetermineVSServicePack.cmake b/Modules/CMakeDetermineVSServicePack.cmake
index b0911b4..9edc309 100644
--- a/Modules/CMakeDetermineVSServicePack.cmake
+++ b/Modules/CMakeDetermineVSServicePack.cmake
@@ -5,7 +5,9 @@
 CMakeDetermineVSServicePack
 ---------------------------
 
-Deprecated.  Do not use.
+.. deprecated:: 3.0
+
+  Do not use.
 
 The functionality of this module has been superseded by the
 :variable:`CMAKE_<LANG>_COMPILER_VERSION` variable that contains
@@ -170,4 +172,3 @@ function(DetermineVSServicePack _pack)
         endif()
     endif()
 endfunction()
-
diff --git a/Modules/CMakeExpandImportedTargets.cmake b/Modules/CMakeExpandImportedTargets.cmake
index 4b97c37..ae26cc2 100644
--- a/Modules/CMakeExpandImportedTargets.cmake
+++ b/Modules/CMakeExpandImportedTargets.cmake
@@ -5,7 +5,9 @@
 CMakeExpandImportedTargets
 --------------------------
 
-Deprecated.  Do not use.
+.. deprecated:: 3.4
+
+  Do not use.
 
 This module was once needed to expand imported targets to the underlying
 libraries they reference on disk for use with the :command:`try_compile`
diff --git a/Modules/CMakeForceCompiler.cmake b/Modules/CMakeForceCompiler.cmake
index ec17c2e..7ac09dc 100644
--- a/Modules/CMakeForceCompiler.cmake
+++ b/Modules/CMakeForceCompiler.cmake
@@ -5,7 +5,9 @@
 CMakeForceCompiler
 ------------------
 
-Deprecated.  Do not use.
+.. deprecated:: 3.6
+
+  Do not use.
 
 The macros provided by this module were once intended for use by
 cross-compiling toolchain files when CMake was not able to automatically
diff --git a/Modules/FindCUDA.cmake b/Modules/FindCUDA.cmake
index 2c8dd81..0f5cab4 100644
--- a/Modules/FindCUDA.cmake
+++ b/Modules/FindCUDA.cmake
@@ -2,19 +2,22 @@
 FindCUDA
 --------
 
-.. note::
-
-  The FindCUDA module has been superseded by first-class support
-  for the CUDA language in CMake.  It is no longer necessary to
-  use this module or call ``find_package(CUDA)``.  This module
-  now exists only for compatibility with projects that have not
-  been ported.
-
-  Instead, list ``CUDA`` among the languages named in the top-level
-  call to the :command:`project` command, or call the
-  :command:`enable_language` command with ``CUDA``.
-  Then one can add CUDA (``.cu``) sources to programs directly
-  in calls to :command:`add_library` and :command:`add_executable`.
+.. deprecated:: 3.10
+
+  Superseded by first-class support for the CUDA language in CMake.
+
+Replacement
+^^^^^^^^^^^
+
+It is no longer necessary to use this module or call ``find_package(CUDA)``.
+Instead, list ``CUDA`` among the languages named in the top-level
+call to the :command:`project` command, or call the
+:command:`enable_language` command with ``CUDA``.
+Then one can add CUDA (``.cu``) sources to programs directly
+in calls to :command:`add_library` and :command:`add_executable`.
+
+Documentation of Deprecated Usage
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Tools for building CUDA C files: libraries and build dependencies.
 
diff --git a/Modules/FindPythonInterp.cmake b/Modules/FindPythonInterp.cmake
index 6a47c15..d1f7b31 100644
--- a/Modules/FindPythonInterp.cmake
+++ b/Modules/FindPythonInterp.cmake
@@ -5,12 +5,12 @@
 FindPythonInterp
 ----------------
 
-Find python interpreter
-
 .. deprecated:: 3.12
 
   Use :module:`FindPython3`, :module:`FindPython2` or :module:`FindPython` instead.
 
+Find python interpreter
+
 This module finds if Python interpreter is installed and determines
 where the executables are.  This code sets the following variables:
 
diff --git a/Modules/FindPythonLibs.cmake b/Modules/FindPythonLibs.cmake
index 2be5d71..1d62ac4 100644
--- a/Modules/FindPythonLibs.cmake
+++ b/Modules/FindPythonLibs.cmake
@@ -5,12 +5,12 @@
 FindPythonLibs
 --------------
 
-Find python libraries
-
 .. deprecated:: 3.12
 
   Use :module:`FindPython3`, :module:`FindPython2` or :module:`FindPython` instead.
 
+Find python libraries
+
 This module finds if Python is installed and determines where the
 include files and libraries are.  It also determines what the name of
 the library is.  This code sets the following variables:
diff --git a/Modules/FindwxWindows.cmake b/Modules/FindwxWindows.cmake
index 7f25671..35840f5 100644
--- a/Modules/FindwxWindows.cmake
+++ b/Modules/FindwxWindows.cmake
@@ -5,13 +5,15 @@
 FindwxWindows
 -------------
 
+.. deprecated:: 3.0
+
+  Replaced by :module:`FindwxWidgets`.
+
 Find wxWindows (wxWidgets) installation
 
 This module finds if wxWindows/wxWidgets is installed and determines
 where the include files and libraries are.  It also determines what
-the name of the library is.  Please note this file is DEPRECATED and
-replaced by FindwxWidgets.cmake.  This code sets the following
-variables:
+the name of the library is.  This code sets the following variables:
 
 ::
 
diff --git a/Modules/TestCXXAcceptsFlag.cmake b/Modules/TestCXXAcceptsFlag.cmake
index 75f1fc3..92a362e 100644
--- a/Modules/TestCXXAcceptsFlag.cmake
+++ b/Modules/TestCXXAcceptsFlag.cmake
@@ -5,7 +5,9 @@
 TestCXXAcceptsFlag
 ------------------
 
-Deprecated.  See :module:`CheckCXXCompilerFlag`.
+.. deprecated:: 3.0
+
+  See :module:`CheckCXXCompilerFlag`.
 
 Check if the CXX compiler accepts a flag.
 
diff --git a/Modules/Use_wxWindows.cmake b/Modules/Use_wxWindows.cmake
index f25ae89..a5e8879 100644
--- a/Modules/Use_wxWindows.cmake
+++ b/Modules/Use_wxWindows.cmake
@@ -5,9 +5,9 @@
 Use_wxWindows
 -------------
 
-Deprecated.  Use ``find_package(wxWidgets)`` and
-``include(${wxWidgets_USE_FILE})`` instead.
+.. deprecated:: 3.14
 
+  Use ``find_package(wxWidgets)`` and ``include(${wxWidgets_USE_FILE})`` instead.
 
 This convenience include finds if wxWindows is installed and set the
 appropriate libs, incdirs, flags etc.  author Jan Woetzel <jw -at-
@@ -67,4 +67,3 @@ if(WXWINDOWS_FOUND)
 else()
   message(SEND_ERROR "wxWindows not found by Use_wxWindows.cmake")
 endif()
-
diff --git a/Modules/WriteBasicConfigVersionFile.cmake b/Modules/WriteBasicConfigVersionFile.cmake
index 0ccb6b2..1f13096 100644
--- a/Modules/WriteBasicConfigVersionFile.cmake
+++ b/Modules/WriteBasicConfigVersionFile.cmake
@@ -5,7 +5,10 @@
 WriteBasicConfigVersionFile
 ---------------------------
 
+.. deprecated:: 3.0
 
+  Use the identical command :command:`write_basic_package_version_file()`
+  from module :module:`CMakePackageConfigHelpers`.
 
 ::
 
@@ -15,8 +18,6 @@ WriteBasicConfigVersionFile
     )
 
 
-
-Deprecated, see WRITE_BASIC_PACKAGE_VERSION_FILE(), it is identical.
 #]=======================================================================]
 
 function(WRITE_BASIC_CONFIG_VERSION_FILE _filename)