| CMAKE_FIND_REQUIRED |
| ------------------- |
| |
| .. versionadded:: 4.1 |
| |
| If enabled, the following commands are treated as having the ``REQUIRED`` |
| keyword unless provided with the ``OPTIONAL`` keyword: |
| |
| * :command:`find_package` |
| * :command:`find_program` |
| * :command:`find_library` |
| * :command:`find_path` |
| * :command:`find_file` |
| |
| When :command:`find_package` loads a ``Find<PackageName>.cmake`` |
| or ``<PackageName>Config.cmake`` module, the ``CMAKE_FIND_REQUIRED`` |
| variable is automatically unset within it to restore the default |
| behavior for nested find operations. The module is free to set the |
| ``CMAKE_FIND_REQUIRED`` variable itself to opt-in to the behavior. |
| |
| Note that enabling this variable breaks some commonly used patterns. |
| Multiple calls to :command:`find_package` are sometimes used to obtain a |
| different search order to the default. |
| |
| See also the :variable:`CMAKE_REQUIRE_FIND_PACKAGE_<PackageName>` variable for |
| making a :command:`find_package` call ``REQUIRED``, and for additional |
| information on how enabling these variables can break commonly used patterns. |
