Help: Use 'deprecated' template, and date deprecation of modules

10 files changed, 42 insertions, 30 deletions

diff --git a/Modules/CMakeDetermineVSServicePack.cmake b/Modules/CMakeDetermineVSServicePack.cmake
index b0911b4bdf..9edc309a04 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 4b97c378d9..ae26cc26e2 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 ec17c2e0de..7ac09dcaa8 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 2c8dd81c8a..0f5cab45c4 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 6a47c157ac..d1f7b31708 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 2be5d71573..1d62ac43ea 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 7f25671a8c..35840f5f95 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 75f1fc36e8..92a362e2ff 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 f25ae895d0..a5e8879cd4 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 0ccb6b28c1..1f13096a29 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)