Find*: Update *_FOUND variables

This marks all `<PACKAGENAME>_FOUND` result variables as deprecated
where possible (for `<PackageName>` find modules) to make it clearer
which variable to use.

In CMake 3.3, the FindPackageHandleStandardArgs module was refactored to
set both `<PackageName>_FOUND` and uppercase `<PACKAGENAME>_FOUND`
result variables to the same values. Before that, the FOUND_VAR argument
could be used to set the result variable.

* FindMatlab: Uppercased MATLAB_FOUND is not mentioned as it was never
  documented.
* Documentation for FindPythonInterp and FindPythonLibs modules synced
  accordingly to their deprecation (3.12 instead of 4.2).
* OPENGL_FOUND: deprecation version synced with other find modules.
* DevIL_FOUND was introduced in CMake 3.8. The uppercased variant not
  mentioned as it was previously never documented.

Fixes: #27242
This commit is contained in:
Peter Kokot
2025-09-23 20:36:50 +02:00
parent 9f190de849
commit 0fedf1592c
141 changed files with 1012 additions and 323 deletions
+12 -4
View File
@@ -34,9 +34,10 @@ Result Variables
This module defines the following variables:
``PythonLibs_FOUND``
Boolean indicating whether the (requested version of) Python libraries have
been found. For backward compatibility, the ``PYTHONLIBS_FOUND`` variable is
also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) Python libraries
were found.
``PYTHONLIBS_VERSION_STRING``
The version of the Python libraries found.
@@ -72,7 +73,14 @@ This module accepts the following variables before calling
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
These variables are provided for backward compatibility:
The following variables are provided for backward compatibility:
``PYTHONLIBS_FOUND``
.. deprecated:: 3.12
Use ``PythonLibs_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) Python libraries
were found.
``PYTHON_DEBUG_LIBRARIES``
.. deprecated:: 2.8.8