mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-02-21 14:40:26 -06:00
Code Issues Packages Projects Releases Wiki Activity

Find*: Update *_FOUND variables

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

4
Help/manual/cmake-developer.7.rst
View File

@@ -361,10 +361,10 @@ reStructuredText-format documentation. For example:
Result Variables
^^^^^^^^^^^^^^^^
This will define the following variables:
This module defines the following variables:
``Foo_FOUND``
True if the system has the Foo library.
Boolean indicating whether (the requested version of) Foo was found.
``Foo_VERSION``
The version of the Foo library which was found.
``Foo_INCLUDE_DIRS``

4
Help/release/dev/find-modules.rst
View File

@@ -1,6 +1,10 @@
Find Modules
------------
* The uppercased ``<PACKAGENAME>_FOUND`` result variables of find modules
are now deprecated in favor of ``<PackageName>_FOUND`` result variables,
where appropriate. See documentation of each find module for details.
* The :module:`FindALSA` module now provides a ``ALSA_VERSION`` result
variable. The ``ALSA_VERSION_STRING`` result variable is deprecated.

3
Modules/FindALSA.cmake
View File

@@ -28,7 +28,8 @@ Result Variables
This module defines the following variables:
``ALSA_FOUND``
Boolean indicating whether (the requested version of) ALSA library is found.
Boolean indicating whether the (requested version of) ALSA library was
found.
``ALSA_VERSION``
.. versionadded:: 4.2

3
Modules/FindASPELL.cmake
View File

@@ -60,7 +60,8 @@ Result Variables
This module defines the following variables:
``ASPELL_FOUND``
Boolean indicating whether the requested Aspell components have been found.
Boolean indicating whether (the requested version of) Aspell and all
requested components were found.
``ASPELL_VERSION``
.. versionadded:: 4.1

18
Modules/FindAVIFile.cmake
View File

@@ -21,10 +21,13 @@ Result Variables
This module defines the following variables:
``AVIFile_FOUND``
Boolean indicating whether AVIFile is found. For backward compatibility,
the ``AVIFILE_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether AVIFile was found.
``AVIFILE_LIBRARIES``
The libraries to link against.
``AVIFILE_DEFINITIONS``
Definitions to use when compiling.
@@ -36,6 +39,17 @@ The following cache variables may also be set:
``AVIFILE_INCLUDE_DIR``
Directory containing ``avifile.h`` and other AVIFile headers.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``AVIFILE_FOUND``
.. deprecated:: 4.2
Use ``AVIFile_FOUND``, which has the same value.
Boolean indicating whether AVIFile was found.
Examples
^^^^^^^^

14
Modules/FindArmadillo.cmake
View File

@@ -24,9 +24,10 @@ Result Variables
This module defines the following variables:
``Armadillo_FOUND``
Boolean indicating whether the (requested version of) Armadillo library is
found. For backward compatibility, the ``ARMADILLO_FOUND`` variable is
also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) Armadillo library
was found.
``Armadillo_VERSION``
.. versionadded:: 4.2
@@ -49,6 +50,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``ARMADILLO_FOUND``
.. deprecated:: 4.2
Use ``Armadillo_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) Armadillo library
was found.
``ARMADILLO_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Armadillo_VERSION``.

2
Modules/FindBISON.cmake
View File

@@ -23,7 +23,7 @@ Result Variables
This module defines the following variables:
``BISON_FOUND``
Boolean indicating whether (the requested version of) Bison is found.
Boolean indicating whether (the requested version of) Bison was found.
``BISON_VERSION``
The version of Bison found.

6
Modules/FindBLAS.cmake
View File

@@ -33,8 +33,8 @@ Result Variables
This module defines the following variables:
``BLAS_FOUND``
Boolean indicating whether the library implementing the BLAS interface is
found.
Boolean indicating whether the library implementing the BLAS interface
was found.
``BLAS_LINKER_FLAGS``
Uncached list of required linker flags (excluding ``-l`` and ``-L``).
``BLAS_LIBRARIES``
@@ -45,7 +45,7 @@ This module defines the following variables:
to use BLAS95 interface.
``BLAS95_FOUND``
Boolean indicating whether the library implementing the BLAS95 interface
is found.
was found.
Input Variables
^^^^^^^^^^^^^^^

14
Modules/FindBZip2.cmake
View File

@@ -28,9 +28,10 @@ Result Variables
This module defines the following variables:
``BZip2_FOUND``
Boolean indicating whether (the requested version of) BZip2 library is
found. For backward compatibility, the ``BZIP2_FOUND`` variable is also
set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) BZip2 library was
found.
``BZip2_VERSION``
.. versionadded:: 4.2
@@ -69,6 +70,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``BZIP2_FOUND``
.. deprecated:: 4.2
Use ``BZip2_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) BZip2 library was
found.
``BZIP2_VERSION_STRING``
.. deprecated:: 3.26
Superseded by the ``BZIP2_VERSION`` (and ``BZip2_VERSION``).

18
Modules/FindBullet.cmake
View File

@@ -17,10 +17,13 @@ Result Variables
This module defines the following variables:
``Bullet_FOUND``
Boolean indicating whether Bullet was found. For backward compatibility,
the ``BULLET_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether Bullet was found.
``BULLET_INCLUDE_DIRS``
The Bullet include directories.
``BULLET_LIBRARIES``
Libraries needed to link to Bullet. By default, all Bullet components
(Dynamics, Collision, LinearMath, and SoftBody) are added.
@@ -34,6 +37,17 @@ This module accepts the following variables:
Can be set to Bullet install path or Windows build path to specify where to
find Bullet.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``BULLET_FOUND``
.. deprecated:: 4.2
Use ``Bullet_FOUND``, which has the same value.
Boolean indicating whether Bullet was found.
Examples
^^^^^^^^

4
Modules/FindCUDAToolkit.cmake
View File

@@ -524,9 +524,11 @@ Target Created:
**Note**: direct usage of this target by consumers should not be necessary.
Result variables
Result Variables
^^^^^^^^^^^^^^^^
This module defines the following variables:
``CUDAToolkit_FOUND``
A boolean specifying whether or not the CUDA Toolkit was found.

6
Modules/FindCURL.cmake
View File

@@ -72,8 +72,8 @@ Result Variables
This module defines the following variables:
``CURL_FOUND``
Boolean indicating whether the (requested version of) curl and all required
components are found.
Boolean indicating whether (the requested version of) curl and all required
components were found.
``CURL_VERSION``
.. versionadded:: 4.0
@@ -84,7 +84,7 @@ This module defines the following variables:
.. versionadded:: 3.14
Boolean indicating whether the specified component (curl protocol or feature)
is found.
was found.
``CURL_INCLUDE_DIRS``
Include directories containing the ``curl/curl.h`` and other headers needed to

2
Modules/FindCVS.cmake
View File

@@ -17,7 +17,7 @@ Result Variables
This module defines the following variables:
``CVS_FOUND``
Boolean indicating whether the command-line client was found.
Boolean indicating whether the ``cvs`` command-line client was found.
Cache Variables
^^^^^^^^^^^^^^^

16
Modules/FindCoin3D.cmake
View File

@@ -20,8 +20,9 @@ Result Variables
This module defines the following variables:
``Coin3D_FOUND``
Boolean indicating whether Coin3D, Open Inventor is found. For backward
compatibility, the ``COIN3D_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether Coin3D, Open Inventor was found.
Cache Variables
^^^^^^^^^^^^^^^
@@ -33,6 +34,17 @@ The following cache variables may also be set:
``COIN3D_LIBRARIES``
Coin3D libraries required for linking.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``COIN3D_FOUND``
.. deprecated:: 4.2
Use ``Coin3D_FOUND``, which has the same value.
Boolean indicating whether Coin3D, Open Inventor was found.
Examples
^^^^^^^^

12
Modules/FindCups.cmake
View File

@@ -28,9 +28,9 @@ Result Variables
This module defines the following variables:
``Cups_FOUND``
Boolean indicating whether (the requested version of) CUPS is found. For
backward compatibility, the ``CUPS_FOUND`` variable is also set to the
same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) CUPS was found.
``Cups_VERSION``
.. versionadded:: 4.2
@@ -65,6 +65,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``CUPS_FOUND``
.. deprecated:: 4.2
Use ``Cups_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) CUPS was found.
``CUPS_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Cups_VERSION``.

13
Modules/FindCurses.cmake
View File

@@ -22,8 +22,9 @@ Result Variables
This module defines the following variables:
``Curses_FOUND``
Boolean indicating whether the Curses is found. For backward compatibility,
the ``CURSES_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether Curses was found.
``CURSES_INCLUDE_DIRS``
.. versionadded:: 3.1
@@ -68,7 +69,13 @@ This module accepts the following variables:
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following legacy variables are provided for backward compatibility:
The following variables are provided for backward compatibility:
``CURSES_FOUND``
.. deprecated:: 4.2
Use ``Curses_FOUND``, which has the same value.
Boolean indicating whether Curses was found.
``CURSES_INCLUDE_DIR``
.. deprecated:: 3.1

2
Modules/FindCxxTest.cmake
View File

@@ -20,7 +20,7 @@ Result Variables
This module defines the following variables:
``CXXTEST_FOUND``
Boolean indicating whether the CxxTest framework is found.
Boolean indicating whether the CxxTest framework was found.
``CXXTEST_INCLUDE_DIRS``
Include directories containing headers needed to use CxxTest.

2
Modules/FindDCMTK.cmake
View File

@@ -73,7 +73,7 @@ Result Variables
This module defines the following variables:
``DCMTK_FOUND``
Boolean indicating whether DCMTK is found.
Boolean indicating whether DCMTK was found.
``DCMTK_INCLUDE_DIRS``
Include directories containing headers needed to use DCMTK.

8
Modules/FindDevIL.cmake
View File

@@ -66,7 +66,9 @@ Result Variables
This module defines the following variables:
``DevIL_FOUND``
Boolean indicating whether the (requested version of) DevIL package is
.. versionadded:: 3.8
Boolean indicating whether the (requested version of) DevIL package was
found, including the IL and ILU libraries.
``DevIL_VERSION``
@@ -77,8 +79,8 @@ This module defines the following variables:
``DevIL_ILUT_FOUND``
.. versionadded:: 3.21
Boolean indicating whether the ILUT library is found. On most systems, ILUT
is found when both IL and ILU are available.
Boolean indicating whether the ILUT library was found. On most systems,
ILUT is found when both IL and ILU are available.
Cache Variables
^^^^^^^^^^^^^^^

19
Modules/FindDoxygen.cmake
View File

@@ -90,10 +90,10 @@ Result Variables
This module defines the following variables:
``Doxygen_FOUND``
Boolean indicating whether (the requested version of) ``doxygen`` executable
and all requested required components are found. For backward compatibility,
the ``DOXYGEN_FOUND`` variable is also set, except it has boolean value of
``YES`` or ``NO``.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) ``doxygen`` executable
and all requested required components were found.
``Doxygen_VERSION``
.. versionadded:: 4.2
@@ -492,6 +492,14 @@ Deprecated Variables
For compatibility with previous versions of CMake, the following variables
are also defined but they are deprecated and should no longer be used:
``DOXYGEN_FOUND``
.. deprecated:: 4.2
Use ``Doxygen_FOUND``.
Boolean indicating whether the (requested version of) ``doxygen`` executable
and all requested required components were found. It has a boolean value
of ``YES`` or ``NO``.
``DOXYGEN_EXECUTABLE``
.. deprecated:: 3.9
Use ``Doxygen::doxygen`` imported target instead of referring to the
@@ -501,8 +509,9 @@ are also defined but they are deprecated and should no longer be used:
``DOXYGEN_DOT_FOUND``
.. deprecated:: 3.9
Use ``Doxygen_dot_FOUND``.
Boolean result variable indicating whether ``dot`` executable is found.
Boolean result variable indicating whether ``dot`` executable was found.
``DOXYGEN_DOT_EXECUTABLE``
.. deprecated:: 3.9

2
Modules/FindEXPAT.cmake
View File

@@ -30,7 +30,7 @@ Result Variables
This module defines the following variables:
``EXPAT_FOUND``
Boolean indicating whether (the requested version of) Expat is found.
Boolean indicating whether (the requested version of) Expat was found.
``EXPAT_VERSION``
.. versionadded:: 4.2

2
Modules/FindEnvModules.cmake
View File

@@ -43,7 +43,7 @@ Result Variables
This module defines the following variables:
``EnvModules_FOUND``
Boolean indicating whether a compatible Environment Modules framework is
Boolean indicating whether a compatible Environment Modules framework was
found.
Cache Variables

2
Modules/FindFLEX.cmake
View File

@@ -23,7 +23,7 @@ Result Variables
This module defines the following variables:
``FLEX_FOUND``
Boolean indicating whether (the requested version of) Flex is found.
Boolean indicating whether (the requested version of) Flex was found.
``FLEX_VERSION``
The version of Flex found.

2
Modules/FindFLTK.cmake
View File

@@ -31,7 +31,7 @@ Result Variables
This module defines the following variables:
``FLTK_FOUND``
Boolean indicating whether FLTK is found.
Boolean indicating whether FLTK was found.
``FLTK_LIBRARIES``
Libraries needed to link against to use FLTK.

2
Modules/FindFLTK2.cmake
View File

@@ -26,7 +26,7 @@ Result Variables
This module defines the following variables:
``FLTK2_FOUND``
Boolean indicating whether FLTK 2.x is found.
Boolean indicating whether FLTK 2.x was found.
``FLTK2_LIBRARIES``
Libraries needed to link against to use FLTK 2.x.

2
Modules/FindFontconfig.cmake
View File

@@ -28,7 +28,7 @@ Result Variables
This module defines the following variables:
``Fontconfig_FOUND``
Boolean indicating whether the (requested version of) Fontconfig is found.
Boolean indicating whether (the requested version of) Fontconfig was found.
``Fontconfig_VERSION``
The version of Fontconfig found.
``Fontconfig_LIBRARIES``

12
Modules/FindFreetype.cmake
View File

@@ -31,9 +31,9 @@ Result Variables
This module defines the following variables:
``Freetype_FOUND``
Boolean indicating whether (the requested version of) Freetype is found.
For backward compatibility, the ``FREETYPE_FOUND`` variable is also set
to the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) Freetype was found.
``Freetype_VERSION``
.. versionadded:: 4.2
@@ -76,6 +76,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``FREETYPE_FOUND``
.. deprecated:: 4.2
Use ``Freetype_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) Freetype was found.
``FREETYPE_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Freetype_VERSION``.

2
Modules/FindGDAL.cmake
View File

@@ -34,7 +34,7 @@ Result Variables
This module defines the following variables:
``GDAL_FOUND``
Boolean indicating whether (the requested version of) GDAL is found.
Boolean indicating whether (the requested version of) GDAL was found.
``GDAL_VERSION``
.. versionadded:: 3.14

2
Modules/FindGIF.cmake
View File

@@ -28,7 +28,7 @@ Result Variables
This module defines the following variables:
``GIF_FOUND``
Boolean indicating whether (the requested version of) GIF library was found.
Boolean indicating whether the (requested version of) GIF library was found.
``GIF_VERSION``
Version string of the GIF library found (for example, ``5.1.4``). For GIF

2
Modules/FindGLEW.cmake
View File

@@ -57,7 +57,7 @@ Result Variables
This module defines the following variables:
``GLEW_FOUND``
Boolean indicating whether (the requested version of) GLEW is found.
Boolean indicating whether (the requested version of) GLEW was found.
``GLEW_VERSION``
.. versionadded:: 3.15

2
Modules/FindGLUT.cmake
View File

@@ -29,7 +29,7 @@ Result Variables
This module defines the following variables:
``GLUT_FOUND``
Boolean indicating whether GLUT is found.
Boolean indicating whether GLUT was found.
``GLUT_INCLUDE_DIRS``
.. versionadded:: 3.23

2
Modules/FindGSL.cmake
View File

@@ -37,7 +37,7 @@ Result Variables
This module defines the following variables:
``GSL_FOUND``
Boolean indicating whether (the requested version of) GSL is found on the
Boolean indicating whether (the requested version of) GSL was found on the
local system.
``GSL_VERSION``
The version of the discovered GSL installation.

4
Modules/FindGTK.cmake
View File

@@ -32,9 +32,9 @@ Result Variables
This module defines the following variables:
``GTK_FOUND``
Boolean indicating whether GTK is found.
Boolean indicating whether GTK was found.
``GTK_GL_FOUND``
Boolean indicating whether GTK's GL features are found.
Boolean indicating whether GTK's GL features were found.
``GTK_INCLUDE_DIR``
Include directories containing headers needed to use GTK.
``GTK_LIBRARIES``

3
Modules/FindGTK2.cmake
View File

@@ -97,7 +97,8 @@ Result Variables
This module defines the following variables:
``GTK2_FOUND``
Boolean indicating whether GTK and all specified components are found.
Boolean indicating whether (the requested version of) GTK 2 and all
specified components were found.
``GTK2_VERSION``
The version of GTK found (x.y.z).
``GTK2_MAJOR_VERSION``

10
Modules/FindGTest.cmake
View File

@@ -78,7 +78,9 @@ Result Variables
This module defines the following variables:
``GTest_FOUND``
Boolean indicating whether GoogleTest is found.
.. versionadded:: 3.3
Boolean indicating whether GoogleTest was found.
Hints
^^^^^
@@ -150,6 +152,12 @@ The following variables are provided for backward compatibility:
Result variable providing both ``gtest`` and ``gtest_main`` libraries
combined.
``GTEST_FOUND``
.. deprecated:: 4.2
Use ``GTest_FOUND``, which has the same value.
Boolean indicating whether GoogleTest was found.
Deprecated Imported Targets
"""""""""""""""""""""""""""

12
Modules/FindGettext.cmake
View File

@@ -36,9 +36,9 @@ Result Variables
This module defines the following variables:
``Gettext_FOUND``
Boolean indicating whether (the requested version of) gettext is found. For
backward compatibility, the ``GETTEXT_FOUND`` variable is also set to the same
value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) gettext was found.
``Gettext_VERSION``
.. versionadded:: 4.2
@@ -201,6 +201,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``GETTEXT_FOUND``
.. deprecated:: 4.2
Use ``Gettext_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) gettext was found.
``GETTEXT_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Gettext_VERSION``.

12
Modules/FindGit.cmake
View File

@@ -31,9 +31,9 @@ Result Variables
This module defines the following variables:
``Git_FOUND``
Boolean indicating whether (the requested version of) Git was found. For
backward compatibility, the ``GIT_FOUND`` variable is also set to the same
value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) Git was found.
``Git_VERSION``
.. versionadded:: 4.2
@@ -53,6 +53,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``GIT_FOUND``
.. deprecated:: 4.2
Use ``Git_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) Git was found.
``GIT_VERSION_STRING``
.. deprecated:: 4.2
Use ``Git_VERSION``, which has the same value.

12
Modules/FindGnuTLS.cmake
View File

@@ -34,9 +34,9 @@ Result Variables
This module defines the following variables:
``GnuTLS_FOUND``
Boolean indicating whether (the requested version of) GnuTLS is found. For
backward compatibility, the ``GNUTLS_FOUND`` variable is also set to the same
value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) GnuTLS was found.
``GnuTLS_VERSION``
.. versionadded:: 4.2
@@ -68,6 +68,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``GNUTLS_FOUND``
.. deprecated:: 4.2
Use ``GnuTLS_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) GnuTLS was found.
``GNUTLS_VERSION_STRING``
.. deprecated:: 3.16
Use the ``GnuTLS_VERSION``, which has the same value.

12
Modules/FindGnuplot.cmake
View File

@@ -18,9 +18,9 @@ Result Variables
This module defines the following variables:
``Gnuplot_FOUND``
Boolean indicating whether (the requested version of) Gnuplot has been
found. For backward compatibility, the ``GNUPLOT_FOUND`` variable is also
set to the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) Gnuplot was found.
``Gnuplot_VERSION``
.. versionadded:: 4.2
@@ -45,6 +45,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``GNUPLOT_FOUND``
.. deprecated:: 4.2
Use ``Gnuplot_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) Gnuplot was found.
``GNUPLOT_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Gnuplot_VERSION``.

2
Modules/FindHDF5.cmake
View File

@@ -127,7 +127,7 @@ Result Variables
This module defines the following variables:
``HDF5_FOUND``
Boolean indicating whether (the requested version of) HDF5 is found.
Boolean indicating whether (the requested version of) HDF5 was found.
``HDF5_VERSION``
.. versionadded:: 3.3

2
Modules/FindHSPELL.cmake
View File

@@ -17,7 +17,7 @@ Result Variables
This module defines the following variables:
``HSPELL_FOUND``
Boolean indicating whether (the requested version of) Hspell is found.
Boolean indicating whether (the requested version of) Hspell was found.
``HSPELL_VERSION``
.. versionadded:: 4.2

16
Modules/FindHg.cmake
View File

@@ -18,9 +18,10 @@ Result Variables
This module defines the following variables:
``Hg_FOUND``
Boolean indicating whether (the requested version of) Mercurial client is
found. For backward compatibility, the ``HG_FOUND`` variable is also set
to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) Mercurial client was
found.
``Hg_VERSION``
.. versionadded:: 4.2
@@ -65,10 +66,19 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``HG_FOUND``
.. deprecated:: 4.2
Use ``Hg_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) Mercurial client was
found.
``HG_VERSION_STRING``
.. deprecated:: 4.2
Use ``Hg_VERSION``, which has the same value.
The version of Mercurial found.
Examples
^^^^^^^^

6
Modules/FindIce.cmake
View File

@@ -93,8 +93,8 @@ Result Variables
This module defines the following variables:
``Ice_FOUND``
Boolean indicating whether the main programs, libraries and all requested
components for using Ice were found.
Boolean indicating whether the (requested version of) main programs,
libraries and all requested components for using Ice were found.
``Ice_VERSION``
The version of Ice release found.
@@ -112,7 +112,7 @@ This module defines the following variables:
Ice component libraries are stored in:
``Ice_<COMPONENT>_FOUND``
Boolean indicating whether the specified Ice component is found. The
Boolean indicating whether the specified Ice component was found. The
``<COMPONENT>`` should be written in uppercase.
``Ice_<COMPONENT>_LIBRARIES``

14
Modules/FindIcotool.cmake
View File

@@ -18,9 +18,10 @@ Result Variables
This module defines the following variables:
``Icotool_FOUND``
Boolean indicating whether (the requested version of) ``icotool`` has been
found. For backward compatibility, the ``ICOTOOL_FOUND`` variable is also
set to the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) ``icotool`` was
found.
``Icotool_VERSION``
.. versionadded:: 4.2
@@ -40,6 +41,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``ICOTOOL_FOUND``
.. deprecated:: 4.2
Use ``Icotool_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) ``icotool`` was
found.
``ICOTOOL_VERSION_STRING``
.. deprecated:: 4.2
Use ``Icotool_VERSION``, which has the same value.

2
Modules/FindImageMagick.cmake
View File

@@ -83,7 +83,7 @@ This module defines the following variables:
``ImageMagick_FOUND``
Boolean indicating whether (the requested version of) ImageMagick and all
its requested components are found.
its requested components were found.
``ImageMagick_VERSION``
.. versionadded:: 4.2

2
Modules/FindIntl.cmake
View File

@@ -34,7 +34,7 @@ Result Variables
This module defines the following variables:
``Intl_FOUND``
Boolean indicating whether (the requested version of) Intl is found.
Boolean indicating whether (the requested version of) Intl was found.
``Intl_VERSION``
.. versionadded:: 3.21

4
Modules/FindJNI.cmake
View File

@@ -99,12 +99,12 @@ Result Variables
This module defines the following variables:
``JNI_FOUND``
Boolean indicating whether the JNI is found.
Boolean indicating whether (the requested version of) JNI was found.
``JNI_<component>_FOUND``
.. versionadded:: 3.24
Boolean indicating whether the ``<component>`` is found.
Boolean indicating whether the ``<component>`` was found.
``JNI_VERSION``
Full Android NDK package version (including suffixes such as ``-beta3`` and

3
Modules/FindJPEG.cmake
View File

@@ -31,7 +31,8 @@ Result Variables
This module defines the following variables:
``JPEG_FOUND``
Boolean indicating whether (the requested version of) JPEG library is found.
Boolean indicating whether the (requested version of) JPEG library was
found.
``JPEG_VERSION``
.. versionadded:: 3.12

12
Modules/FindJasper.cmake
View File

@@ -29,9 +29,9 @@ Result Variables
This module defines the following variables:
``Jasper_FOUND``
Boolean indicating whether (the requested version of) JasPer is found.
For backward compatibility, the ``JASPER_FOUND`` variable is also set to
the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) JasPer was found.
``Jasper_VERSION``
.. versionadded:: 4.2
@@ -66,6 +66,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``JASPER_FOUND``
.. deprecated:: 4.2
Use ``Jasper_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) JasPer was found.
``JASPER_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Jasper_VERSION``.

7
Modules/FindJava.cmake
View File

@@ -55,10 +55,13 @@ Result Variables
This module defines the following variables:
``Java_FOUND``
Boolean indicating whether Java with all specified components is found.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) Java with all
specified components was found.
``Java_<component>_FOUND``
Boolean indicating whether the ``<component>`` is found.
Boolean indicating whether the ``<component>`` was found.
``Java_VERSION``
Version of Java found. This is set to:

2
Modules/FindKDE3.cmake
View File

@@ -29,7 +29,7 @@ Result Variables
This module defines the following variables:
``KDE3_FOUND``
Boolean indicating whether KDE 3 is found.
Boolean indicating whether KDE 3 was found.
``KDE3_DEFINITIONS``
Compiler definitions required for compiling KDE 3 software.
``KDE3_INCLUDE_DIRS``

4
Modules/FindLAPACK.cmake
View File

@@ -34,7 +34,7 @@ This module defines the following variables:
``LAPACK_FOUND``
Boolean indicating whether the library implementing the LAPACK interface
is found.
was found.
``LAPACK_LINKER_FLAGS``
Uncached list of required linker flags (excluding ``-l`` and ``-L``).
``LAPACK_LIBRARIES``
@@ -45,7 +45,7 @@ This module defines the following variables:
LAPACK95.
``LAPACK95_FOUND``
Boolean indicating whether the library implementing the LAPACK95 interface
is found.
was found.
Input Variables
^^^^^^^^^^^^^^^

4
Modules/FindLATEX.cmake
View File

@@ -73,10 +73,10 @@ This module defines the following variables:
``LATEX_FOUND``
Boolean indicating whether the LaTex compiler and all its required components
are found.
were found.
``LATEX_<component>_FOUND``
Boolean indicating whether the LaTeX ``<component>`` is found.
Boolean indicating whether the LaTeX ``<component>`` was found.
Cache Variables
^^^^^^^^^^^^^^^

11
Modules/FindLTTngUST.cmake
View File

@@ -29,8 +29,8 @@ Result Variables
This module defines the following variables:
``LTTngUST_FOUND``
Boolean indicating whether the LTTng-UST library is found. For backward
compatibility, the ``LTTNGUST_FOUND`` variable is also set to the same value.
Boolean indicating whether the (requested version of) LTTng-UST library
was found.
``LTTngUST_VERSION``
.. versionadded:: 4.2
@@ -58,6 +58,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``LTTNGUST_FOUND``
.. deprecated:: 4.2
Use ``LTTngUST_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) LTTng-UST library
was found.
``LTTNGUST_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``LTTngUST_VERSION``.

12
Modules/FindLibLZMA.cmake
View File

@@ -29,9 +29,9 @@ Result Variables
This module defines the following variables:
``LibLZMA_FOUND``
Boolean indicating whether (the requested version of) liblzma is found.
For backward compatibility, the ``LIBLZMA_FOUND`` variable is also set to
the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) liblzma was found.
``LibLZMA_VERSION``
.. versionadded:: 4.2
@@ -66,6 +66,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``LIBLZMA_FOUND``
.. deprecated:: 4.2
Use ``LibLZMA_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) liblzma was found.
``LIBLZMA_VERSION``
.. versionadded:: 3.26
.. deprecated:: 4.2

11
Modules/FindLibXml2.cmake
View File

@@ -34,7 +34,9 @@ Result Variables
This module defines the following variables:
``LibXml2_FOUND``
Boolean indicating whether (the requested version of) libxml2 library is
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) libxml2 library was
found.
``LibXml2_VERSION``
@@ -70,6 +72,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``LIBXML2_FOUND``
.. deprecated:: 4.2
Use ``LibXml2_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) libxml2 library was
found.
``LIBXML2_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``LibXml2_VERSION``.

12
Modules/FindLibXslt.cmake
View File

@@ -40,9 +40,9 @@ Result Variables
This module defines the following variables:
``LibXslt_FOUND``
Boolean indicating whether (the requested version of) libxslt is found.
For backward compatibility, the ``LIBXSLT_FOUND`` variable is also set to
the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) libxslt was found.
``LibXslt_VERSION``
.. versionadded:: 4.2
@@ -82,6 +82,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``LIBXSLT_FOUND``
.. deprecated:: 4.2
Use ``LibXslt_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) libxslt was found.
``LIBXSLT_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``LibXslt_VERSION``.

2
Modules/FindLibinput.cmake
View File

@@ -29,7 +29,7 @@ Result Variables
This module defines the following variables:
``Libinput_FOUND``
Boolean indicating whether the (requested version of) libinput library is
Boolean indicating whether the (requested version of) libinput library was
found.
``Libinput_VERSION``
The version of the libinput found.

12
Modules/FindLua.cmake
View File

@@ -38,9 +38,9 @@ Result Variables
This module defines the following variables:
``Lua_FOUND``
Boolean indicating whether (the requested version of) Lua is found. For
backward compatibility, the ``LUA_FOUND`` variable is also set to the same
value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) Lua was found.
``Lua_VERSION``
.. versionadded:: 4.2
@@ -80,6 +80,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``LUA_FOUND``
.. deprecated:: 4.2
Use ``Lua_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) Lua was found.
``LUA_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Lua_VERSION``.

16
Modules/FindLua50.cmake
View File

@@ -41,8 +41,9 @@ Result Variables
This module defines the following variables:
``Lua50_FOUND``
Boolean indicating whether Lua is found. For backward compatibility, the
``LUA50_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether Lua was found.
Cache Variables
^^^^^^^^^^^^^^^
@@ -57,6 +58,17 @@ The following cache variables may also be set:
Libraries needed to link against to use Lua. This list includes both ``lua``
and ``lualib`` libraries.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``LUA50_FOUND``
.. deprecated:: 4.2
Use ``Lua50_FOUND``, which has the same value.
Boolean indicating whether Lua was found.
Examples
^^^^^^^^

12
Modules/FindLua51.cmake
View File

@@ -41,9 +41,9 @@ Result Variables
This module defines the following variables:
``Lua51_FOUND``
Boolean indicating whether (the requested version of) Lua is found. For
backward compatibility, the ``LUA51_FOUND`` variable is also set to the
same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) Lua was found.
``Lua_VERSION``
.. versionadded:: 4.2
@@ -67,6 +67,12 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``LUA51_FOUND``
.. deprecated:: 4.2
Use ``Lua51_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) Lua was found.
``LUA_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Lua_VERSION``.

2
Modules/FindMFC.cmake
View File

@@ -26,7 +26,7 @@ Result Variables
This module defines the following variables:
``MFC_FOUND``
Boolean indicating whether MFC support is found.
Boolean indicating whether MFC support was found.
Examples
^^^^^^^^

2
Modules/FindMPEG.cmake
View File

@@ -28,7 +28,7 @@ Result Variables
This module defines the following variables:
``MPEG_FOUND``
Boolean indicating whether the libmpeg2 library is found.
Boolean indicating whether the libmpeg2 library was found.
``MPEG_LIBRARIES``
Libraries needed to link against to use libmpeg2.

2
Modules/FindMPEG2.cmake
View File

@@ -23,7 +23,7 @@ Result Variables
This module defines the following variables:
``MPEG2_FOUND``
Boolean indicating whether the libmpeg2 library is found.
Boolean indicating whether the libmpeg2 library was found.
``MPEG2_LIBRARIES``
Libraries needed to link against to use libmpeg2.

17
Modules/FindMPI.cmake
View File

@@ -75,10 +75,11 @@ Result Variables
This module defines the following variables:
``MPI_FOUND``
Boolean variable indicating that MPI settings for all requested components
(languages) have been found. If no components are specified, this is
true if MPI settings for all enabled languages were detected. Note that
the ``MPICXX`` component does not affect this variable.
Boolean indicating that MPI settings for all requested components
(languages) were found. If no components are specified, this variable is
set to boolean true if MPI settings for all enabled languages were
detected. Note that the ``MPICXX`` component does not affect this
variable.
``MPI_VERSION``
Minimal version of MPI detected among the requested languages, or all
@@ -88,8 +89,8 @@ This module will set the following variables per language in CMake project,
where ``<lang>`` is one of C, CXX, or Fortran:
``MPI_<lang>_FOUND``
Boolean variable indicating the MPI settings for ``<lang>`` were found
and that simple MPI test programs compile with the provided settings.
Boolean indicating the MPI settings for ``<lang>`` were found and that
simple MPI test programs compile with the provided settings.
``MPI_<lang>_COMPILER``
MPI compiler for ``<lang>`` if such a program exists.
@@ -115,8 +116,8 @@ The following variables indicating which bindings are present will be
defined:
``MPI_MPICXX_FOUND``
Boolean variable indicating whether the MPI-2 C++ bindings are present
(introduced in MPI-2, removed with MPI-3).
Boolean indicating whether the MPI-2 C++ bindings are present (introduced
in MPI-2, removed with MPI-3).
``MPI_Fortran_HAVE_F77_HEADER``
True if the Fortran 77 header ``<mpif.h>`` is available.

7
Modules/FindMatlab.cmake
View File

@@ -152,8 +152,11 @@ Result variables
""""""""""""""""
``Matlab_FOUND``
``TRUE`` if the Matlab installation is found, ``FALSE``
otherwise. All variable below are defined if Matlab is found.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) Matlab installation
was found. All variables below are defined if Matlab is found.
``Matlab_VERSION``
.. versionadded:: 3.27

16
Modules/FindMotif.cmake
View File

@@ -17,8 +17,9 @@ Result Variables
This module defines the following variables:
``Motif_FOUND``
Boolean indicating whether the Motif was found. For backward compatibility,
the ``MOTIF_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether Motif was found.
Cache Variables
^^^^^^^^^^^^^^^
@@ -31,6 +32,17 @@ The following cache variables may also be set:
``MOTIF_LIBRARIES``
Libraries needed to link to Motif.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``MOTIF_FOUND``
.. deprecated:: 4.2
Use ``Motif_FOUND``, which has the same value.
Boolean indicating whether Motif was found.
Examples
^^^^^^^^

2
Modules/FindODBC.cmake
View File

@@ -41,7 +41,7 @@ Result Variables
This module defines the following variables:
``ODBC_FOUND``
Boolean indicating whether ODBC is found.
Boolean indicating whether ODBC was found.
``ODBC_INCLUDE_DIRS``
Include directories containing headers needed to use ODBC.

7
Modules/FindOpenACC.cmake
View File

@@ -37,14 +37,15 @@ This module defines the following variables:
``OpenACC_FOUND``
.. versionadded:: 3.25
Boolean variable indicating that OpenACC flags for at least one languages
have been found.
Boolean indicating that OpenACC flags for at least one language were
found.
This module will set the following variables per language in the
project, where ``<lang>`` is one of C, CXX, or Fortran:
``OpenACC_<lang>_FOUND``
Boolean variable indicating if OpenACC support for ``<lang>`` was detected.
Boolean indicating whether OpenACC support for language ``<lang>`` was
detected.
``OpenACC_<lang>_FLAGS``
OpenACC compiler flags for ``<lang>``, separated by spaces.
``OpenACC_<lang>_OPTIONS``

17
Modules/FindOpenAL.cmake
View File

@@ -38,8 +38,10 @@ Result Variables
This module defines the following variables:
``OpenAL_FOUND``
Boolean indicating whether the OpenAL is found. For backward compatibility,
the ``OPENAL_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) OpenAL was found.
``OPENAL_VERSION_STRING``
Human-readable string containing the version of OpenAL found.
@@ -53,6 +55,17 @@ The following cache variables may also be set:
``OPENAL_LIBRARY``
The path to the OpenAL library.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``OPENAL_FOUND``
.. deprecated:: 4.2
Use ``OpenAL_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) OpenAL was found.
Hints
^^^^^

22
Modules/FindOpenGL.cmake
View File

@@ -125,38 +125,38 @@ This module defines the following variables:
``OpenGL_FOUND``
.. versionadded:: 3.3
Boolean indicating whether the OpenGL and all requested components are found.
Boolean indicating whether OpenGL and all requested components were found.
``OPENGL_XMESA_FOUND``
Boolean indicating whether OpenGL XMESA is found.
Boolean indicating whether OpenGL XMESA was found.
``OPENGL_GLU_FOUND``
Boolean indicating whether GLU is found.
Boolean indicating whether GLU was found.
``OpenGL_OpenGL_FOUND``
.. versionadded:: 3.10
Boolean indicating whether GLVND OpenGL library is found.
Boolean indicating whether the GLVND OpenGL library was found.
``OpenGL_GLX_FOUND``
.. versionadded:: 3.10
Boolean indicating whether GLVND GLX is found.
Boolean indicating whether GLVND GLX was found.
``OpenGL_EGL_FOUND``
.. versionadded:: 3.10
Boolean indicating whether GLVND EGL is found.
Boolean indicating whether GLVND EGL was found.
``OpenGL_GLES2_FOUND``
.. versionadded:: 3.27
Boolean indicating whether GLES2 is found.
Boolean indicating whether GLES2 was found.
``OpenGL_GLES3_FOUND``
.. versionadded:: 3.27
Boolean indicating whether GLES3 is found.
Boolean indicating whether GLES3 was found.
``OPENGL_INCLUDE_DIRS``
.. versionadded:: 3.29
@@ -301,8 +301,10 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``OPENGL_FOUND``
.. deprecated:: 3.3
Superseded by the ``OpenGL_FOUND``, which has the same value.
.. deprecated:: 4.2
Use ``OpenGL_FOUND``, which has the same value.
Boolean indicating whether OpenGL and all requested components were found.
Examples
^^^^^^^^

9
Modules/FindOpenMP.cmake
View File

@@ -78,9 +78,12 @@ Result Variables
This module defines the following variables:
``OpenMP_FOUND``
Boolean variable indicating that OpenMP flags for all requested languages
have been found. If no components are specified, this is true if OpenMP
settings for all enabled languages were detected.
.. versionadded:: 3.10
Boolean indicating that OpenMP flags for all requested languages were
found. If no components are specified, this variable is set to boolean
true if OpenMP settings for all enabled languages were detected.
``OpenMP_VERSION``
Minimal version of the OpenMP standard detected among the requested
languages, or all enabled languages if no components were specified.

14
Modules/FindOpenSSL.cmake
View File

@@ -99,9 +99,10 @@ Result Variables
This module defines the following variables:
``OpenSSL_FOUND``
Boolean indicating whether (the requested version of) OpenSSL library has
been found. For backward compatibility, the ``OPENSSL_FOUND`` variableđ
is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) OpenSSL library was
found.
``OpenSSL_VERSION``
.. versionadded:: 4.2
@@ -162,6 +163,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``OPENSSL_FOUND``
.. deprecated:: 4.2
Use ``OpenSSL_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) OpenSSL library was
found.
``OPENSSL_VERSION``
.. deprecated:: 4.2
Superseded by the ``OpenSSL_VERSION``.

14
Modules/FindOpenSceneGraph.cmake
View File

@@ -157,9 +157,10 @@ Result Variables
This module defines the following variables:
``OpenSceneGraph_FOUND``
Boolean indicating whether (the requested version of) OpenSceneGraph with all
specified components is found. For backward compatibility, the
``OPENSCENEGRAPH_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) OpenSceneGraph with
all specified components was found.
``OpenSceneGraph_VERSION``
.. versionadded:: 4.2
@@ -208,6 +209,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``OPENSCENEGRAPH_FOUND``
.. deprecated:: 4.2
Use ``OpenSceneGraph_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) OpenSceneGraph with
all specified components was found.
``OPENSCENEGRAPH_VERSION``
.. deprecated:: 4.2
Superseded by the ``OpenSceneGraph_VERSION``.

17
Modules/FindOpenThreads.cmake
View File

@@ -24,9 +24,9 @@ Result Variables
This module defines the following variables:
``OpenThreads_FOUND``
Boolean indicating whether OpenThreads library is found. For backward
compatibility, the ``OPENTHREADS_FOUND`` variable is also set to the same
value.
.. versionadded:: 3.3
Boolean indicating whether the OpenThreads library was found.
``OPENTHREADS_LIBRARY``
Libraries needed to link against to use OpenThreads. This provides either
@@ -71,6 +71,17 @@ OpenSceneGraph, this module also honors the following variables for convenience:
``OSGDIR``
Environment variable treated the same as ``OPENTHREADS_DIR``.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``OPENTHREADS_FOUND``
.. deprecated:: 4.2
Use ``OpenThreads_FOUND``, which has the same value.
Boolean indicating whether the OpenThreads library was found.
Examples
^^^^^^^^

8
Modules/FindPHP4.cmake
View File

@@ -19,6 +19,14 @@ Finds PHP version 4, a general-purpose scripting language:
This module checks if PHP 4 is installed and determines the locations of the
include directories and the PHP command-line interpreter.
Result Variables
^^^^^^^^^^^^^^^^
This module defines the following variables:
``PHP4_FOUND``
Boolean indicating whether PHP 4 was found.
Cache Variables
^^^^^^^^^^^^^^^

2
Modules/FindPNG.cmake
View File

@@ -33,7 +33,7 @@ Result Variables
This module defines the following variables:
``PNG_FOUND``
Boolean indicating whether (the requested version of) PNG library is found.
Boolean indicating whether the (requested version of) PNG library was found.
``PNG_VERSION``
.. versionadded:: 4.2

2
Modules/FindPatch.cmake
View File

@@ -33,7 +33,7 @@ Result Variables
This module defines the following variables:
``Patch_FOUND``
Boolean indicating whether the ``patch`` command-line executable is found.
Boolean indicating whether the ``patch`` command-line executable was found.
Cache Variables
^^^^^^^^^^^^^^^

14
Modules/FindPerl.cmake
View File

@@ -19,9 +19,10 @@ Result Variables
This module defines the following variables:
``Perl_FOUND``
Boolean indicating whether the (requested version of) Perl executable is
found. For backward compatibility, the ``PERL_FOUND`` variable is also
set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) Perl executable was
found.
``Perl_VERSION``
.. versionadded:: 4.2
@@ -41,6 +42,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``PERL_FOUND``
.. deprecated:: 4.2
Use ``Perl_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) Perl executable was
found.
``PERL_VERSION_STRING``
.. deprecated:: 4.2
Superseded by the ``Perl_VERSION``.

19
Modules/FindPerlLibs.cmake
View File

@@ -23,9 +23,10 @@ Result Variables
This module defines the following variables:
``PerlLibs_FOUND``
Boolean indicating whether the (requested version of) Perl library
(``perl.h`` and ``libperl``) is found. For backward compatibility, the
``PERLLIBS_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) ``<perl.h>`` and
``libperl`` were found.
``PerlLibs_VERSION``
.. versionadded:: 4.2
@@ -65,6 +66,18 @@ The following cache variables may also be set:
``PERL_EXECUTABLE``
Full path to the ``perl`` executable.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``PERLLIBS_FOUND``
.. deprecated:: 4.2
Use ``PerlLibs_FOUND``, which has the same value.
Boolean indicating whether (the requested version of) ``<perl.h>`` and
``libperl`` were found.
Examples
^^^^^^^^

16
Modules/FindPhysFS.cmake
View File

@@ -17,8 +17,9 @@ Result Variables
This module defines the following variables:
``PhysFS_FOUND``
Boolean indicating whether PhysicsFS library is found. For backward
compatibility, the ``PHYSFS_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the PhysicsFS library was found.
Cache Variables
^^^^^^^^^^^^^^^
@@ -42,6 +43,17 @@ This module accepts the following variables:
destination that was used when configuring, building, and installing PhysicsFS
library: ``./configure --prefix=$PHYSFSDIR``.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``PHYSFS_FOUND``
.. deprecated:: 4.2
Use the ``PhysFS_FOUND``, which has the same value.
Boolean indicating whether the PhysicsFS library was found.
Examples
^^^^^^^^

4
Modules/FindPkgConfig.cmake
View File

@@ -30,7 +30,7 @@ This module defines the following variables:
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) ``pkg-config``
executable is found.
executable was found.
``PkgConfig_VERSION``
.. versionadded:: 4.2
@@ -342,7 +342,7 @@ The following variables are provided for backward compatibility:
Use ``PkgConfig_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) ``pkg-config``
executable is found.
executable was found.
``PKG_CONFIG_VERSION_STRING``
.. deprecated:: 4.2

2
Modules/FindPostgreSQL.cmake
View File

@@ -31,7 +31,7 @@ This module defines the following variables:
``PostgreSQL_FOUND``
Boolean indicating whether the minimum required version and components of
PostgreSQL have been found.
PostgreSQL were found.
``PostgreSQL_VERSION``
.. versionadded:: 4.2

16
Modules/FindProducer.cmake
View File

@@ -35,8 +35,9 @@ Result Variables
This module defines the following variables:
``Producer_FOUND``
Boolean indicating whether Producer is found. For backward compatibility, the
``PRODUCER_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether Producer was found.
Cache Variables
^^^^^^^^^^^^^^^
@@ -72,6 +73,17 @@ multiple OpenSceneGraph-related libraries at once:
``OSG_DIR``
Environment variable treated the same as ``PRODUCER_DIR``.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``PRODUCER_FOUND``
.. deprecated:: 4.2
Use ``Producer_FOUND``, which has the same value.
Boolean indicating whether Producer was found.
Examples
^^^^^^^^

7
Modules/FindProtobuf.cmake
View File

@@ -78,8 +78,11 @@ Result Variables
This module defines the following variables:
``Protobuf_FOUND``
Boolean indicating whether (the requested version of) Protobuf library is
found.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) Protobuf library
was found.
``Protobuf_VERSION``
.. versionadded:: 3.6

20
Modules/FindPython.cmake
View File

@@ -155,9 +155,9 @@ This module defines the following variables
(see :ref:`Standard Variable Names <CMake Developer Standard Variable Names>`):
``Python_FOUND``
System has the Python requested components.
Boolean indicating whether system has the Python requested components.
``Python_Interpreter_FOUND``
System has the Python interpreter.
Boolean indicating whether system has the Python interpreter.
``Python_EXECUTABLE``
Path to the Python interpreter.
``Python_EXECUTABLE_DEBUG``
@@ -219,7 +219,7 @@ This module defines the following variables
string.
``Python_Compiler_FOUND``
System has the Python compiler.
Boolean indicating whether system has the Python compiler.
``Python_COMPILER``
Path to the Python compiler. Only offered by IronPython.
``Python_COMPILER_ID``
@@ -232,23 +232,25 @@ This module defines the following variables
The ``.Net`` interpreter. Only used by ``IronPython`` implementation.
``Python_Development_FOUND``
System has the Python development artifacts.
Boolean indicating whether system has the Python development artifacts.
``Python_Development.Module_FOUND``
.. versionadded:: 3.18
System has the Python development artifacts for Python module.
Boolean indicating whether system has the Python development artifacts
for Python module.
``Python_Development.SABIModule_FOUND``
.. versionadded:: 3.26
System has the Python development artifacts for Python module using the
Stable Application Binary Interface.
Boolean indicating whether system has the Python development artifacts
for Python module using the Stable Application Binary Interface.
``Python_Development.Embed_FOUND``
.. versionadded:: 3.18
System has the Python development artifacts for Python embedding.
Boolean indicating whether system has the Python development artifacts
for Python embedding.
``Python_INCLUDE_DIRS``
@@ -306,7 +308,7 @@ This module defines the following variables
``Python_NumPy_FOUND``
.. versionadded:: 3.14
System has the NumPy.
Boolean indicating whether system has the NumPy.
``Python_NumPy_INCLUDE_DIRS``
.. versionadded:: 3.14

16
Modules/FindPython2.cmake
View File

@@ -142,9 +142,9 @@ This module defines the following variables
(see :ref:`Standard Variable Names <CMake Developer Standard Variable Names>`):
``Python2_FOUND``
System has the Python 2 requested components.
Boolean indicating whether system has the Python 2 requested components.
``Python2_Interpreter_FOUND``
System has the Python 2 interpreter.
Boolean indicating whether system has the Python 2 interpreter.
``Python2_EXECUTABLE``
Path to the Python 2 interpreter.
``Python2_EXECUTABLE_DEBUG``
@@ -190,7 +190,7 @@ This module defines the following variables
Information returned by ``sysconfig.get_path('platlib')`` or else
``distutils.sysconfig.get_python_lib(plat_specific=True,standard_lib=False)``.
``Python2_Compiler_FOUND``
System has the Python 2 compiler.
Boolean indicating whether system has the Python 2 compiler.
``Python2_COMPILER``
Path to the Python 2 compiler. Only offered by IronPython.
``Python2_COMPILER_ID``
@@ -203,17 +203,19 @@ This module defines the following variables
The ``.Net`` interpreter. Only used by ``IronPython`` implementation.
``Python2_Development_FOUND``
System has the Python 2 development artifacts.
Boolean indicating whether system has the Python 2 development artifacts.
``Python2_Development.Module_FOUND``
.. versionadded:: 3.18
System has the Python 2 development artifacts for Python module.
Boolean indicating whether 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.
Boolean indicating whether system has the Python 2 development artifacts
for Python embedding.
``Python2_INCLUDE_DIRS``
The Python 2 include directories.
@@ -253,7 +255,7 @@ This module defines the following variables
``Python2_NumPy_FOUND``
.. versionadded:: 3.14
System has the NumPy.
Boolean indicating whether system has the NumPy.
``Python2_NumPy_INCLUDE_DIRS``
.. versionadded:: 3.14

20
Modules/FindPython3.cmake
View File

@@ -157,9 +157,9 @@ This module defines the following variables
(see :ref:`Standard Variable Names <CMake Developer Standard Variable Names>`):
``Python3_FOUND``
System has the Python 3 requested components.
Boolean indicating whether system has the Python 3 requested components.
``Python3_Interpreter_FOUND``
System has the Python 3 interpreter.
Boolean indicating whether system has the Python 3 interpreter.
``Python3_EXECUTABLE``
Path to the Python 3 interpreter.
``Python3_EXECUTABLE_DEBUG``
@@ -221,7 +221,7 @@ This module defines the following variables
string.
``Python3_Compiler_FOUND``
System has the Python 3 compiler.
Boolean indicating whether system has the Python 3 compiler.
``Python3_COMPILER``
Path to the Python 3 compiler. Only offered by IronPython.
``Python3_COMPILER_ID``
@@ -235,23 +235,25 @@ This module defines the following variables
``Python3_Development_FOUND``
System has the Python 3 development artifacts.
Boolean indicating whether system has the Python 3 development artifacts.
``Python3_Development.Module_FOUND``
.. versionadded:: 3.18
System has the Python 3 development artifacts for Python module.
Boolean indicating whether system has the Python 3 development artifacts
for Python module.
``Python3_Development.SABIModule_FOUND``
.. versionadded:: 3.26
System has the Python 3 development artifacts for Python module using the
Stable Application Binary Interface.
Boolean indicating whether system has the Python 3 development artifacts
for Python module using the Stable Application Binary Interface.
``Python3_Development.Embed_FOUND``
.. versionadded:: 3.18
System has the Python 3 development artifacts for Python embedding.
Boolean indicating whether system has the Python 3 development artifacts
for Python embedding.
``Python3_INCLUDE_DIRS``
@@ -309,7 +311,7 @@ This module defines the following variables
``Python3_NumPy_FOUND``
.. versionadded:: 3.14
System has the NumPy.
Boolean indicating whether system has the NumPy.
``Python3_NumPy_INCLUDE_DIRS``
.. versionadded:: 3.14

20
Modules/FindPythonInterp.cmake
View File

@@ -39,9 +39,11 @@ Result Variables
This module defines the following variables:
``PythonInterp_FOUND``
Boolean indicating whether the (requested version of) Python executable is
found. For backward compatibility, the ``PYTHONINTERP_FOUND`` variable is
also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) Python executable
was found.
``PYTHON_VERSION_STRING``
Python version found (e.g., ``2.5.2``).
``PYTHON_VERSION_MAJOR``
@@ -69,6 +71,18 @@ This module accepts the following variables before calling
This variable can be used to specify a list of version numbers that should be
taken into account when searching for Python.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``PYTHONINTERP_FOUND``
.. deprecated:: 3.12
Use ``PythonInterp_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) Python executable
was found.
Examples
^^^^^^^^

16
Modules/FindPythonLibs.cmake
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

4
Modules/FindQt.cmake
View File

@@ -39,9 +39,9 @@ Result Variables
This module defines the following variables:
``QT4_INSTALLED``
``TRUE`` if Qt4 is found.
``TRUE`` if Qt4 was found.
``QT3_INSTALLED``
``TRUE`` if Qt3 is found.
``TRUE`` if Qt3 was found.
Hints
^^^^^

4
Modules/FindQt3.cmake
View File

@@ -26,11 +26,11 @@ This module defines the following variables:
``Qt3_FOUND``
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) Qt3 is found.
Boolean indicating whether (the requested version of) Qt3 was found.
``QT_FOUND``
Same as ``Qt3_FOUND``. Boolean indicating whether (the requested version
of) Qt3 is found. This variable is provided for compatibility with other
of) Qt3 was found. This variable is provided for compatibility with other
Qt find modules.
``Qt3_VERSION``

4
Modules/FindQt4.cmake
View File

@@ -127,11 +127,11 @@ Result Variables
This module defines the following variables:
``Qt4_FOUND``
Boolean indicating whether (the requested version of) Qt4 is found.
Boolean indicating whether (the requested version of) Qt4 was found.
``QT_FOUND``
Same as ``Qt4_FOUND``. Boolean indicating whether (the requested version
of) Qt4 is found. This variable is available for compatibility with
of) Qt4 was found. This variable is available for compatibility with
other Qt find modules.
``QT_VERSION_MAJOR``

16
Modules/FindQuickTime.cmake
View File

@@ -24,8 +24,9 @@ Result Variables
This module defines the following variables:
``QuickTime_FOUND``
Boolean indicating whether the QuickTime is found. For backward
compatibility, the ``QUICKTIME_FOUND`` variable is also set to the same value.
.. versionadded:: 3.3
Boolean indicating whether QuickTime was found.
Cache Variables
^^^^^^^^^^^^^^^
@@ -49,6 +50,17 @@ This module accepts the following variables:
destination that was used when configuring, building, and installing QuickTime
library: ``./configure --prefix=$QUICKTIME_DIR``.
Deprecated Variables
^^^^^^^^^^^^^^^^^^^^
The following variables are provided for backward compatibility:
``QUICKTIME_FOUND``
.. deprecated:: 4.2
Use ``QuickTime_FOUND``, which has the same value.
Boolean indicating whether QuickTime was found.
Examples
^^^^^^^^

2
Modules/FindRTI.cmake
View File

@@ -23,7 +23,7 @@ Result Variables
This module defines the following variables:
``RTI_FOUND``
Boolean indicating whether HLA RTI is found.
Boolean indicating whether HLA RTI was found.
``RTI_LIBRARIES``
The libraries to link against to use RTI.
``RTI_DEFINITIONS``

4
Modules/FindRuby.cmake
View File

@@ -21,7 +21,9 @@ Result Variables
This module defines the following variables:
``Ruby_FOUND``
Boolean indicating whether (the requested version of) ruby is found.
.. versionadded:: 3.3
Boolean indicating whether (the requested version of) ruby was found.
``Ruby_VERSION``
The version of ruby which was found, e.g. ``3.2.6``.

2
Modules/FindSDL.cmake
View File

@@ -51,7 +51,7 @@ Result Variables
This module defines the following variables:
``SDL_FOUND``
Boolean indicating whether the (requested version of) SDL is found.
Boolean indicating whether (the requested version of) SDL was found.
``SDL_VERSION``
.. versionadded:: 3.19

12
Modules/FindSDL_gfx.cmake
View File

@@ -34,9 +34,8 @@ Result Variables
This module defines the following variables:
``SDL_gfx_FOUND``
Boolean indicating whether (the requested version of) SDL_gfx library is
found. For backward compatibility, the ``SDL_GFX_FOUND`` variable is also set
to the same value.
Boolean indicating whether the (requested version of) SDL_gfx library was
found.
``SDL_gfx_VERSION``
.. versionadded:: 4.2
@@ -70,6 +69,13 @@ Deprecated Variables
The following variables are provided for backward compatibility:
``SDL_GFX_FOUND``
.. deprecated:: 4.2
Use ``SDL_gfx_FOUND``, which has the same value.
Boolean indicating whether the (requested version of) SDL_gfx library was
found.
``SDL_GFX_VERSION_STRING``
.. deprecated:: 4.2
Use the ``SDL_gfx_VERSION``.

19
Modules/FindSDL_image.cmake
View File

@@ -27,9 +27,10 @@ Result Variables
This module defines the following variables:
``SDL_image_FOUND``
Boolean indicating whether the (requested version of) SDL_image library is
found. For backward compatibility, the ``SDL_IMAGE_FOUND`` variable is also
set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) SDL_image library
was found.
``SDL_image_VERSION``
.. versionadded:: 4.2
@@ -60,21 +61,25 @@ The following variables are provided for backward compatibility:
``SDL_IMAGE_VERSION_STRING``
.. deprecated:: 4.2
Use the ``SDL_image_VERSION``.
Use ``SDL_image_VERSION``, which has the same value.
The human-readable string containing the version of SDL_image found.
``SDL_IMAGE_FOUND``
.. deprecated:: 4.2
Use ``SDL_image_FOUND``, which has the same value.
``SDLIMAGE_FOUND``
.. deprecated:: 2.8.10
Use the ``SDL_image_FOUND``, which has the same value.
Use ``SDL_image_FOUND``, which has the same value.
``SDLIMAGE_INCLUDE_DIR``
.. deprecated:: 2.8.10
Use the ``SDL_IMAGE_INCLUDE_DIRS``, which has the same value.
Use ``SDL_IMAGE_INCLUDE_DIRS``, which has the same value.
``SDLIMAGE_LIBRARY``
.. deprecated:: 2.8.10
Use the ``SDL_IMAGE_LIBRARIES``, which has the same value.
Use ``SDL_IMAGE_LIBRARIES``, which has the same value.
Examples
^^^^^^^^

13
Modules/FindSDL_mixer.cmake
View File

@@ -26,9 +26,10 @@ Result Variables
This module defines the following variables:
``SDL_mixer_FOUND``
Boolean indicating whether the (requested version of) SDL_mixer library is
found. For backward compatibility, the ``SDL_MIXER_FOUND`` variable is also
set to the same value.
.. versionadded:: 3.3
Boolean indicating whether the (requested version of) SDL_mixer library
was found.
``SDL_mixer_VERSION``
.. versionadded:: 4.2
@@ -59,10 +60,14 @@ The following variables are provided for backward compatibility:
``SDL_MIXER_VERSION_STRING``
.. deprecated:: 4.2
Use the ``SDL_mixer_VERSION``.
Use ``SDL_mixer_VERSION``, which has the same value.
The human-readable string containing the version of SDL_mixer found.
``SDL_MIXER_FOUND``
.. deprecated:: 4.2
Use ``SDL_mixer_FOUND``, which has the same value.
``SDLMIXER_FOUND``
.. deprecated:: 2.8.10
Use ``SDL_mixer_FOUND``, which has the same value.

Some files were not shown because too many files have changed in this diff Show More