This module could be directly called from the CMake root directory but
it is more convenient for projects to wrap it inside a local script and
call that script instead.
This updates the documentation and syncs with other modules.
This module now provides a DevIL_VERSION result variable and supports
the `<version>` argument in the find_package() call. Version range can
be also specified.
Fixes: #26858
- Refactored and synced module documentation.
- Moved all documentation to the top header comment to make it easier to
manage and adjust.
- Added table of contents.
- Added intro code block showing how to use this module.
- Described arguments of commands as a list.
- Used word "commands" instead of "functions".
- Added separate examples section with more examples.
- Extended the deprecation notice.
- Synced modules descriptions with other similar modules.
- Added info about the MacroAddFileDependencies deprecation in the
3.14 release notes.
This deprecates the GNUTLS_VERSION result variable.
Instead of setting the version from pkg-config, the header files can be
used. GnuTLS versions 2.7.2 and later define the GNUTLS_VERSION in
`<gnutls/gnutls.h>` header. Earlier versions defined LIBGNUTLS_VERSION.
If finding such string in header is not successful, fallback to version
from pkg-config is used.
Issue: #27088
- Synced module documentation with other find modules.
- Added intro code block showing how to use this module.
- Added separate examples section with more examples.
- Moved all documentation to the top header comment to make it easier
to manage and adjust.
- Documented commands arguments as a list.
- Removed internal comment defining "Local variables" for some editors
(other files don't have these defined).
- Changed variable references definitions to a normal list, as these
don't seem to be needed to be referenced in other documentation files
and to be more synced with other find modules. In case some special
environment variable, should be referenced, it can be added in the
future to the variables section directly and to be foundable on the
variables index list.
- Briefly described also PKG_CONFIG_PATH and PKG_CONFIG environment
variables, as they are already mentioned in the descriptions.
- Added "See Also" section.
- Added intro code block showing how to use this module.
- Added separate examples section.
- Renamed "macros" to "commands".
- Synced commands descriptions to other modules.
- Used lowercase style for command names.
- Used "commands" instead of "functions".
- Added separate examples section.
- Moved FOUND_VAR argument to the bottom as it is deprecated.
- Reworded descriptions.
- Added intro code block showing how to use this module.
- Added examples section.
- Moved CMake versions that introduced specific target or variable
to the item instead of above the list, as there are multiple versions
and to have option to extend the items further in the future.
- Synced the module descriptions a bit with the other find modules.
- OpenGL_FOUND variable used (CMake 3.3). Uppercased OPENGL_FOUND is
also set to the same value by the find_package_handle_standard_args().
* GetPrerequisites:
- Added intro code block showing how to include this module.
- Renamed "functions" to "commands".
- Moved command descriptions above their signatures.
- Added initial example of migrating the `gp_append_unique()` command.
* BundleUtilities:
- Replaced obsolete gp_append_unique(): Instead of using the
deprecated `gp_append_unique()`, these usages can be replaced with
`if()` and `list(APPEND)` commands directly.
- Synced module documentation with other similar find modules.
- Added intro code block showing how to use this module.
- Used Threads_FOUND variable in module code. The uppercase
THREADS_FOUND is also set to the same value by
find_package_handle_standard_args().
- Added examples section.
- Added extended explanation of multithreading support and how this
compares to the threading specified by C/C++ standards.
- Added intro code block showing how to use this module.
- Added separate examples section.
- Updated and synced module documentation with other similar find
modules.
