Help: FindPython: add version information

1 files changed, 73 insertions, 12 deletions

diff --git a/Modules/FindPython2.cmake b/Modules/FindPython2.cmake
index 5277e33d8c..6b722ff55c 100644
--- a/Modules/FindPython2.cmake
+++ b/Modules/FindPython2.cmake
@@ -10,25 +10,32 @@ FindPython2
 Find Python 2 interpreter, compiler and development environment (include
 directories and libraries).
 
-When a version is requested, it can be specified as a simple value or as a
-range. For a detailed description of version range usage and capabilities,
-refer to the :command:`find_package` command.
+.. versionadded:: 3.19
+  When a version is requested, it can be specified as a simple value or as a
+  range. For a detailed description of version range usage and capabilities,
+  refer to the :command:`find_package` command.
 
 The following components are supported:
 
 * ``Interpreter``: search for Python 2 interpreter
 * ``Compiler``: search for Python 2 compiler. Only offered by IronPython.
 * ``Development``: search for development artifacts (include directories and
-  libraries). This component includes two sub-components which can be specified
-  independently:
+  libraries).
 
-  * ``Development.Module``: search for artifacts for Python 2 module
-    developments.
-  * ``Development.Embed``: search for artifacts for Python 2 embedding
-    developments.
+  .. versionadded:: 3.18
+    This component includes two sub-components which can be specified
+    independently:
+
+    * ``Development.Module``: search for artifacts for Python 2 module
+      developments.
+    * ``Development.Embed``: search for artifacts for Python 2 embedding
+      developments.
 
 * ``NumPy``: search for NumPy include directories.
 
+.. versionadded:: 3.14
+  Added ``NumPy`` component.
+
 If no ``COMPONENTS`` are specified, ``Interpreter`` is assumed.
 
 If component ``Development`` is specified, it implies sub-components
@@ -57,20 +64,29 @@ for you.
 Imported Targets
 ^^^^^^^^^^^^^^^^
 
-This module defines the following :ref:`Imported Targets <Imported Targets>`
-(when :prop_gbl:`CMAKE_ROLE` is ``PROJECT``):
+This module defines the following :ref:`Imported Targets <Imported Targets>`:
+
+.. versionchanged:: 3.14
+  :ref:`Imported Targets <Imported Targets>` are only created when
+  :prop_gbl:`CMAKE_ROLE` is ``PROJECT``.
 
 ``Python2::Interpreter``
   Python 2 interpreter. Target defined if component ``Interpreter`` is found.
 ``Python2::Compiler``
   Python 2 compiler. Target defined if component ``Compiler`` is found.
 ``Python2::Module``
+  .. versionadded:: 3.15
+
   Python 2 library for Python module. Target defined if component
   ``Development.Module`` is found.
+
 ``Python2::Python``
   Python 2 library for Python embedding. Target defined if component
   ``Development.Embed`` is found.
+
 ``Python2::NumPy``
+  .. versionadded:: 3.14
+
   NumPy library for Python 2. Target defined if component ``NumPy`` is found.
 
 Result Variables
@@ -124,19 +140,34 @@ This module will set the following variables in your project
 ``Python2_COMPILER_ID``
   A short string unique to the compiler. Possible values include:
     * IronPython
+
 ``Python2_DOTNET_LAUNCHER``
+  .. versionadded:: 3.18
+
   The ``.Net`` interpreter. Only used by ``IronPython`` implementation.
+
 ``Python2_Development_FOUND``
   System has the Python 2 development artifacts.
+
 ``Python2_Development.Module_FOUND``
+  .. versionadded:: 3.18
+
   System has the Python 2 development artifacts for Python module.
+
 ``Python2_Development.Embed_FOUND``
+  .. versionadded:: 3.18
+
   System has the Python 2 development artifacts for Python embedding.
+
 ``Python2_INCLUDE_DIRS``
   The Python 2 include directories.
+
 ``Python2_LINK_OPTIONS``
+  .. versionadded:: 3.19
+
   The Python 2 link options. Some configurations require specific link options
   for a correct build and execution.
+
 ``Python2_LIBRARIES``
   The Python 2 libraries.
 ``Python2_LIBRARY_DIRS``
@@ -151,13 +182,25 @@ This module will set the following variables in your project
   Python 2 minor version.
 ``Python2_VERSION_PATCH``
   Python 2 patch version.
+
 ``Python2_PyPy_VERSION``
+  .. versionadded:: 3.18
+
   Python 2 PyPy version.
+
 ``Python2_NumPy_FOUND``
+  .. versionadded:: 3.14
+
   System has the NumPy.
+
 ``Python2_NumPy_INCLUDE_DIRS``
+  .. versionadded:: 3.14
+
   The NumPy include directories.
+
 ``Python2_NumPy_VERSION``
+  .. versionadded:: 3.14
+
   The NumPy version.
 
 Hints
@@ -173,6 +216,8 @@ Hints
   * If set to FALSE, search **only** for shared libraries.
 
 ``Python2_FIND_STRATEGY``
+  .. versionadded:: 3.15
+
   This variable defines how lookup will be done.
   The ``Python2_FIND_STRATEGY`` variable can be set to one of the following:
 
@@ -185,6 +230,8 @@ Hints
     This is the default if policy :policy:`CMP0094` is set to ``NEW``.
 
 ``Python2_FIND_REGISTRY``
+  .. versionadded:: 3.13
+
   On Windows the ``Python2_FIND_REGISTRY`` variable determine the order
   of preference between registry and environment variables.
   the ``Python2_FIND_REGISTRY`` variable can be set to one of the following:
@@ -195,6 +242,8 @@ Hints
   * ``NEVER``: Never try to use registry.
 
 ``Python2_FIND_FRAMEWORK``
+  .. versionadded:: 3.15
+
   On macOS the ``Python2_FIND_FRAMEWORK`` variable determine the order of
   preference between Apple-style and unix-style package components.
   This variable can take same values as :variable:`CMAKE_FIND_FRAMEWORK`
@@ -208,6 +257,8 @@ Hints
   variable will be used, if any.
 
 ``Python2_FIND_VIRTUALENV``
+  .. versionadded:: 3.15
+
   This variable defines the handling of virtual environments managed by
   ``virtualenv`` or ``conda``. It is meaningful only when a virtual environment
   is active (i.e. the ``activate`` script has been evaluated). In this case, it
@@ -226,6 +277,9 @@ Hints
     ``NEVER`` to select preferably the interpreter from the virtual
     environment.
 
+  .. versionadded:: 3.17
+    Added support for ``conda`` environments.
+
   .. note::
 
     If the component ``Development`` is requested, it is **strongly**
@@ -233,6 +287,8 @@ Hints
     result.
 
 ``Python2_FIND_IMPLEMENTATIONS``
+  .. versionadded:: 3.18
+
   This variable defines, in an ordered list, the different implementations
   which will be searched. The ``Python2_FIND_IMPLEMENTATIONS`` variable can
   hold the following values:
@@ -266,7 +322,6 @@ Hints
     through the ``PATH`` variable.
 
 ``Python2_FIND_UNVERSIONED_NAMES``
-
   .. versionadded:: 3.20
 
   This variable defines how the generic names will be searched. Currently, it
@@ -284,6 +339,8 @@ Hints
 Artifacts Specification
 ^^^^^^^^^^^^^^^^^^^^^^^
 
+.. versionadded:: 3.16
+
 To solve special cases, it is possible to specify directly the artifacts by
 setting the following variables:
 
@@ -294,6 +351,8 @@ setting the following variables:
   The path to the compiler.
 
 ``Python2_DOTNET_LAUNCHER``
+  .. versionadded:: 3.18
+
   The ``.Net`` interpreter. Only used by ``IronPython`` implementation.
 
 ``Python2_LIBRARY``
@@ -330,6 +389,8 @@ specification. So, to enable also interactive specification, module behavior
 can be controlled with the following variable:
 
 ``Python2_ARTIFACTS_INTERACTIVE``
+  .. versionadded:: 3.18
+
   Selects the behavior of the module. This is a boolean variable:
 
   * If set to ``TRUE``: Create CMake cache entries for the above artifact