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 adds the `<PackageName>_VERSION` result variables and deprecates
the `<PackageName>_VERSION_STRING` result variables for the following
modules:
* FindSDL_gfx
* FindSDL_image
* FindSDL_mixer
* FindSDL_net
* FindSDL_sound
* FindSDL_ttf
Issue: #27088
This updates the following modules:
- FindSDL
- FindSDL_gfx
- FindSDL_image
- FindSDL_mixer
- FindSDL_net
- FindSDL_sound
- FindSDL_ttf
Changes:
- Synced modules documentation.
- Added examples sections.
- Used the ``<PackageName>_FOUND`` variables. The uppercased
``<PACKAGENAME>_FOUND`` variables are also set to the same value as of
CMake 3.3.
- Added notes regarding the CMake package configuration files
provided by upstream distributions with separate imported targets.
- Find modules index sorted alphabetically for FindSDL* modules.