Martin Duffy 857a039d66 find_*: Add variable to default calls to REQUIRED ...

This adds a `CMAKE_FIND_REQUIRED` variable which causes `find_package`,
`find_path`, `find_file`, `find_library` and `find_program` to be
considered `REQUIRED` by default.

It also introduces an `OPTIONAL` keyword to those commands, allowing
them to ignore the value of this variable.

Issue: #26576

2025-02-27 10:51:07 -05:00

..

add_compile_definitions.rst

…

add_compile_options.rst

Help: Clarify that {add,target}_compile_options are not used for linking

2023-03-31 11:30:51 -04:00

add_custom_command.rst

Help: Remove accidental blockquotes around lists

2025-01-31 12:23:29 -05:00

add_custom_target.rst

Help: Remove stray spaces and one colon

2025-01-31 12:23:29 -05:00

add_definitions.rst

…

add_dependencies.rst

Help: Document MANUALLY_ADDED_DEPENDENCIES in add_dependencies

2024-03-29 18:43:30 +01:00

add_executable.rst

Help: Add cmake-buildsystem(7) subsections for each binary target type

2024-12-13 09:53:26 -05:00

add_library.rst

Help: Add cmake-buildsystem(7) subsections for each binary target type

2024-12-13 09:53:26 -05:00

add_link_options.rst

Help: Clarify that {add,target}_compile_options are not used for linking

2023-03-31 11:30:51 -04:00

add_subdirectory.rst

Help: improve docs for the EXCLUDE_FROM_ALL directory property

2024-06-04 16:58:54 +02:00

add_test.rst

Help: Document CTest module BUILD_TESTING variable

2024-10-24 11:46:37 -04:00

aux_source_directory.rst

…

block.rst

Help: Remove stray spaces and one colon

2025-01-31 12:23:29 -05:00

break.rst

…

build_command.rst

CMP0061: Remove support for OLD behavior

2025-01-22 10:40:54 -05:00

build_name.rst

…

cmake_file_api.rst

cmake_file_api: New project command

2023-06-05 06:20:50 -04:00

cmake_host_system_information.rst

Help: More syntax highlighting for literal blocks

2025-01-29 16:48:53 -05:00

cmake_instrumentation.rst

instrumentation: Add experimental notes to docs

2025-02-11 13:47:56 -05:00

cmake_language.rst

try_compile: Propagating top level includes into whole-project calls

2024-05-30 19:01:03 +10:00

cmake_minimum_required.rst

Help/cmake_minimum_required: clarify policy_max versionadded note

2025-02-18 06:20:32 +01:00

cmake_parse_arguments.rst

Help: Recommend good prefixes for cmake_parse_arguments, expand example

2024-08-31 18:33:14 +10:00

cmake_path.rst

Help: Remove accidental blockquotes around lists

2025-01-31 12:23:29 -05:00

cmake_pkg_config.rst

Help: More syntax highlighting for literal blocks

2025-01-29 16:48:53 -05:00

cmake_policy.rst

Help: De-duplicate policy version documentation

2025-02-13 12:36:54 -05:00

configure_file.rst

Help: Remove stray spaces and one colon

2025-01-31 12:23:29 -05:00

continue.rst

…

create_test_sourcelist.rst

Help: Document create_test_sourcelist source path convention

2024-02-22 09:37:23 -05:00

ctest_build.rst

…

ctest_configure.rst

…

ctest_coverage.rst

…

ctest_empty_binary_directory.rst

…

ctest_memcheck.rst

…

ctest_read_custom_files.rst

…

ctest_run_script.rst

CTest: Remove declarative scripting mode

2024-10-09 22:30:58 +02:00

ctest_sleep.rst

…

ctest_start.rst

…

ctest_submit.rst

Help: Convert some literal blocks into tables and lists

2025-01-31 12:23:29 -05:00

ctest_test.rst

ctest: Allow passing -j without value to choose a contextual default

2024-03-10 11:41:39 -04:00

ctest_update.rst

…

ctest_upload.rst

…

define_property.rst

Help: Convert some literal blocks into tables and lists

2025-01-31 12:23:29 -05:00

DEPRECATED_POLICY_VERSIONS.txt

Remove compatibility with CMake versions older than 3.5

2025-01-22 10:40:55 -05:00

DEVICE_LINK_OPTIONS.txt

…

else.rst

Remove optional arguments from else() and end*() commands

2025-01-28 03:01:23 +01:00

elseif.rst

…

enable_language.rst

enable_language(): Fail if called before project()

2024-04-02 23:00:38 +11:00

enable_testing.rst

Help: Document CTest module BUILD_TESTING variable

2024-10-24 11:46:37 -04:00

endblock.rst

…

endforeach.rst

…

endfunction.rst

…

endif.rst

…

endmacro.rst

…

endwhile.rst

…

exec_program.rst

exec_program(): Remove by policy CMP0153

2023-07-25 11:09:56 -04:00

execute_process.rst

execute_process: Clarify when a Windows command interpreter is used

2025-02-11 07:26:56 -05:00

export_library_dependencies.rst

…

export.rst

EXPORT_PACKAGE_DEPENDENCIES: Add experimental feature gate

2024-03-12 14:24:53 -04:00

file.rst

Help: Remove stray spaces and one colon

2025-01-31 12:23:29 -05:00

find_file.rst

find_(library|file|path): Drop PATH-derived search prefixes

2023-09-14 15:13:50 -04:00

find_library.rst

Help: Clarify find_library() behavior for suffixed libraries

2025-02-11 08:50:59 -05:00

find_package.rst

find_*: Add variable to default calls to REQUIRED

2025-02-27 10:51:07 -05:00

find_path.rst

find_(library|file|path): Drop PATH-derived search prefixes

2023-09-14 15:13:50 -04:00

find_program.rst

Help: Document find_program filename suffix behavior

2024-10-03 08:00:41 -04:00

FIND_XXX_ORDER.txt

…

FIND_XXX_REGISTRY_VIEW.txt

…

FIND_XXX_ROOT.txt

…

FIND_XXX.txt

find_*: Add variable to default calls to REQUIRED

2025-02-27 10:51:07 -05:00

fltk_wrap_ui.rst

Help: Remove stray spaces and one colon

2025-01-31 12:23:29 -05:00

foreach.rst

ci: Extend spellcheck job with 'typos' tool

2025-01-22 08:51:45 -05:00

function.rst

…

GENEX_NOTE.txt

…

get_cmake_property.rst

Help: Use <variable> consistently in property getter commands

2024-01-05 15:37:39 +11:00

get_directory_property.rst

…

get_filename_component.rst

Help: Convert some literal blocks into tables and lists

2025-01-31 12:23:29 -05:00

get_property.rst

Help: get_property() result var is unset if property is not set

2024-08-23 09:58:46 +10:00

get_source_file_property.rst

Help: Fix wrong return values for unset inherited properties

2024-01-05 17:40:16 +11:00

get_target_property.rst

Help: Fix wrong return values for unset inherited properties

2024-01-05 17:40:16 +11:00

get_test_property.rst

Help: Fix wrong return values for unset inherited properties

2024-01-05 17:40:16 +11:00

if.rst

Help: Fix typos found by the rst-backticks hook

2025-01-27 01:43:26 +04:00

include_directories.rst

codespell: Fix typos

2023-05-22 16:51:15 -04:00

include_external_msproject.rst

Help: Explicitly state include_external_msproject is only for VS generators

2024-09-25 07:24:32 -04:00

include_guard.rst

…

include_regular_expression.rst

Help: Convert some literal blocks into tables and lists

2025-01-31 12:23:29 -05:00

include.rst

…

install_files.rst

…

install_programs.rst

…

install_targets.rst

…

install.rst

Use lower case style for commands

2025-01-28 13:51:46 -05:00

link_directories.rst

…

LINK_LIBRARIES_LINKER.txt

Renumber post-3.31 development from 3.32 to 4.0

2025-01-16 09:18:21 -05:00

link_libraries.rst

…

LINK_OPTIONS_LINKER.txt

…

list.rst

regex: Match ^ at most once in repeated searches

2025-02-13 20:00:02 +05:00

load_cache.rst

load_cache: Add note about export()

2025-01-28 15:22:29 +01:00

load_command.rst

Help: Convert some literal blocks into tables and lists

2025-01-31 12:23:29 -05:00

macro.rst

Help: Fix inaccurate use of "function" in macro docs

2024-05-21 09:13:57 -04:00

make_directory.rst

…

mark_as_advanced.rst

…

math.rst

…

message.rst

…

option.rst

…

OPTIONS_SHELL.txt

…

output_required_files.rst

…

POLICY_VERSION.txt

Add CMAKE_POLICY_VERSION_MINIMUM to help configure outdated projects

2025-02-13 14:00:26 -05:00

project.rst

project: Always set <PROJECT-NAME>_* as normal variables

2024-10-08 10:07:11 -04:00

qt_wrap_cpp.rst

Autogen: Update Documentation

2024-02-08 09:16:37 -05:00

qt_wrap_ui.rst

…

remove_definitions.rst

…

remove.rst

…

return.rst

Help: Fix example for return command

2024-02-15 10:42:25 -05:00

separate_arguments.rst

Help: Remove accidental blockquotes around lists

2025-01-31 12:23:29 -05:00

set_directory_properties.rst

Help: Use <xxx> for non-keyword arguments in property command signatures

2024-01-05 15:31:39 +11:00

set_property.rst

set_property(TEST): Add DIRECTORY option

2023-08-10 17:36:14 -04:00

set_source_files_properties.rst

Help: Remove accidental blockquotes around lists

2025-01-31 12:23:29 -05:00

set_target_properties.rst

Help: Use <xxx> for non-keyword arguments in property command signatures

2024-01-05 15:31:39 +11:00

set_tests_properties.rst

Help: Add missing DIRECTORY keyword to set_tests_properties() signature

2024-01-05 16:45:27 +11:00

set.rst

Help: Remove "this command" ambiguity in set() docs

2023-09-01 21:28:56 +10:00

site_name.rst

…

source_group.rst

…

string.rst

string: Allow zero-length matches in all REGEX subcommands

2025-02-15 01:01:49 +05:00

subdir_depends.rst

…

subdirs.rst

Help: Remove stray spaces and one colon

2025-01-31 12:23:29 -05:00

SUPPORTED_LANGUAGES.txt

…

target_compile_definitions.rst

Help: Update cmake-buildsystem(7) build and usage requirements

2024-04-24 09:06:32 -04:00

target_compile_features.rst

…

target_compile_options.rst

Help: Update cmake-buildsystem(7) build and usage requirements

2024-04-24 09:06:32 -04:00

target_include_directories.rst

Help: Update cmake-buildsystem(7) build and usage requirements

2024-04-24 09:06:32 -04:00

target_link_directories.rst

Help: Update cmake-buildsystem(7) build and usage requirements

2024-04-24 09:06:32 -04:00

target_link_libraries.rst

Help: Clarify context of target_link_libraries pre-4.0 behavior documentation

2025-02-11 09:30:57 -05:00

target_link_options.rst

Help: Update cmake-buildsystem(7) build and usage requirements

2024-04-24 09:06:32 -04:00

target_precompile_headers.rst

Help: Update cmake-buildsystem(7) build and usage requirements

2024-04-24 09:06:32 -04:00

target_sources.rst

Help: Update cmake-buildsystem(7) build and usage requirements

2024-04-24 09:06:32 -04:00

try_compile.rst

Merge topic 'msvc-runtime-checks'

2025-01-30 08:48:01 -05:00

try_run.rst

Help: Note try_compile/try_run caching

2024-12-18 10:04:47 -05:00

UNSET_NOTE.txt

Help: Clarify that set(VAR) unsets VAR

2023-03-24 14:44:45 -04:00

unset.rst

Help: Clarify that set(VAR) unsets VAR

2023-03-24 14:44:45 -04:00

use_mangled_mesa.rst

…

utility_source.rst

…

variable_requires.rst

…

variable_watch.rst

…

while.rst

…

write_file.rst

Help: Use CMake highlighting for command synopsis

2022-11-09 23:52:30 +04:00