Tyler Yankee 67f253a8d2 Help: Factor out "may use generator expressions" ...

This had already been factored out to `GENEX_NOTE.rst`, but wasn't
applied very widely. Consolidate the language to consistently spell out
(a) the reference to `cmake-buildsystem(7)` and (b) the prose 'with the
syntax "$<...>"'.

To accompany the change, modify cmRST to override redefinitions of
substitutions within a single context instead of appending. Otherwise,
with the new note files, `cmake --help-*` prints repeated fragments
when it collates all scopes of a given field (e.g., all
`prop_*/COMPILE_OPTIONS.rst` from
`cmake --help-property COMPILE_OPTIONS`).

2026-10-13 11:46:56 -04:00

..

include

Help: Factor out "may use generator expressions"

2026-10-13 11:46:56 -04:00

add_compile_definitions.rst

Diagnostics: Warn about non-target directives

2026-07-28 11:38:20 -04:00

add_compile_options.rst

Diagnostics: Warn about non-target directives

2026-07-28 11:38:20 -04:00

add_custom_command.rst

Add support of custom rules

2026-09-20 11:43:10 +02:00

add_custom_rule.rst

Add support of custom rules

2026-09-20 11:43:10 +02:00

add_custom_target.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

add_definitions.rst

Diagnostics: Warn about non-target directives

2026-07-28 11:38:20 -04:00

add_dependencies.rst

ALIAS: Add support for add_dependencies for ALIAS targets

2026-07-08 11:51:51 -04:00

add_executable.rst

ALIAS: Add support for install and export commands

2026-07-10 17:01:49 -07:00

add_library.rst

ALIAS: Add support for install and export commands

2026-07-10 17:01:49 -07:00

add_link_options.rst

Diagnostics: Warn about non-target directives

2026-07-28 11:38:20 -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: Add target names description to cmake-buildsystem(7)

2026-10-12 12:23:44 -04:00

aux_source_directory.rst

Help: Improve documentation links and formatting

2019-03-27 16:01:20 +01:00

block.rst

Diagnostics: Implement diagnostic stack

2026-03-18 14:32:21 -04:00

break.rst

…

build_command.rst

Help: Add roles to abbreviate command-line options

2026-03-31 12:56:16 -04:00

build_name.rst

Help: Use CMake highlighting for command synopsis

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

cmake_diagnostic.rst

Diagnostics: Add cmake_diagnostic command

2026-03-19 11:29:44 -04:00

cmake_file_api.rst

cmake_file_api: New project command

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

cmake_host_system_information.rst

cmake_host_system_information: select host vs sysroot for DISTRIB_*

2026-09-02 14:48:36 +02:00

cmake_instrumentation.rst

Instrumentation: Add Process Resource Usage Metrics

2026-08-27 10:24:25 -04:00

cmake_language.rst

Help: Move regex specification to cmake-language(7)

2026-09-07 10:17:42 -04:00

cmake_minimum_required.rst

Help: Be more explicit about what ...<policy_max> does not mean

2025-12-02 15:25:47 -05:00

cmake_parse_arguments.rst

cmake_parse_arguments: Add PARSE_ARGN mode

2026-06-01 18:06:25 -04:00

cmake_path.rst

cmake_path: An empty path is not a prefix of any path

2026-09-17 10:05:27 -04:00

cmake_pkg_config.rst

PkgC: Add NAME and PREFIX

2025-03-14 15:17:27 -04:00

cmake_policy.rst

Help: Be more explicit about what ...<policy_max> does not mean

2025-12-02 15:25:47 -05:00

configure_file.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

continue.rst

Help: clean up and clarify block() and return()

2022-11-08 00:05:55 +11:00

create_test_sourcelist.rst

TestDriver: Add '-N' option to print all tests

2026-03-26 10:36:22 -04:00

ctest_build.rst

ctest: prioritize presets over existing DartConfiguration.tcl commands

2026-05-29 11:40:47 -04:00

ctest_configure.rst

ctest: prioritize presets over existing DartConfiguration.tcl commands

2026-05-29 11:40:47 -04:00

ctest_coverage.rst

Help/ctest_*: Improve documentation around the edges

2026-04-13 14:32:01 -04:00

ctest_empty_binary_directory.rst

Help/ctest_*: Improve documentation around the edges

2026-04-13 14:32:01 -04:00

ctest_memcheck.rst

CTest: Make ctest_test() label filters multi-value (AND)

2026-07-24 21:27:58 +02:00

ctest_read_custom_files.rst

Help/ctest_*: Improve documentation around the edges

2026-04-13 14:32:01 -04:00

ctest_run_script.rst

Help/ctest_*: Improve documentation around the edges

2026-04-13 14:32:01 -04:00

ctest_sleep.rst

Help/ctest_*: Improve documentation around the edges

2026-04-13 14:32:01 -04:00

ctest_start.rst

Help/ctest_*: Improve documentation around the edges

2026-04-13 14:32:01 -04:00

ctest_submit.rst

ctest: add new variable CTEST_SUBMIT_PARTS

2026-06-03 10:45:42 -04:00

ctest_test.rst

Merge topic 'ctest-dashboard-preset-env'

2026-09-18 07:59:56 -04:00

ctest_update.rst

ctest_update: Add options VERSION_ONLY and VERSION_OVERRIDE

2026-05-12 13:45:00 +02:00

ctest_upload.rst

Help/ctest_*: Improve documentation around the edges

2026-04-13 14:32:01 -04:00

define_property.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

discover_tests.rst

ctest: Interpret relative paths in BUILD_DEPENDS

2026-10-09 13:56:22 -04:00

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: add support for usage in subdirectories

2026-08-07 11:05:57 -04:00

enable_testing.rst

enable_testing: Update docs

2026-02-04 17:32:54 +01:00

endblock.rst

Add new flow-control commands for variables and policies scopes management

2022-08-22 16:25:53 +02:00

endforeach.rst

…

endfunction.rst

…

endif.rst

…

endmacro.rst

…

endwhile.rst

…

exec_program.rst

exec_program: Add example how to upgrade to execute_process()

2025-04-17 01:02:47 +02:00

execute_process.rst

execute_process: Add options for modified environment

2026-03-12 19:17:24 +01:00

export_library_dependencies.rst

Help: Use CMake highlighting for command synopsis

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

export.rst

Experimental: Remove SBOM experimental gate

2026-10-04 22:22:55 -04:00

file.rst

Help: Move regex specification to cmake-language(7)

2026-09-07 10:17:42 -04:00

find_file.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

find_library.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

find_package.rst

ci(pre-commit): version bump typos hook + fix found typos

2026-08-29 05:26:37 +04:00

find_path.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

find_program.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

fltk_wrap_ui.rst

Help: Remove stray spaces and one colon

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

foreach.rst

Help: Improve clarity of foreach behavior

2025-08-13 16:29:18 -04:00

function.rst

function: Set variable ARGNC

2026-06-15 10:54:48 -07:00

get_cmake_property.rst

Help: Use <variable> consistently in property getter commands

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

get_directory_property.rst

Help: Add _See Also_ sections to related CMake commands

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

get_filename_component.rst

Help: Improve formatting for cmake_host_system_information

2026-01-15 20:30:17 -05:00

get_property.rst

Add support of custom rules

2026-09-20 11:43:10 +02: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

if() command: add RULE operator

2026-09-21 18:10:48 +02:00

include_directories.rst

Diagnostics: Warn about non-target directives

2026-07-28 11:38:20 -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

Help: remove links from pages to themselves

2022-11-18 14:09:32 -05:00

include_regular_expression.rst

Help: Convert some literal blocks into tables and lists

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

include.rst

Diagnostics: Implement diagnostic stack

2026-03-18 14:32:21 -04:00

install_files.rst

Help: Use CMake highlighting for command synopsis

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

install_programs.rst

Help: Use CMake highlighting for command synopsis

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

install_targets.rst

Help: Use CMake highlighting for command synopsis

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

install.rst

install: Add BUILD_DEPENDS option for install_prep targets

2026-10-12 13:58:14 -04:00

link_directories.rst

Help: add and make references to generators consistent

2025-06-12 21:25:24 +02:00

link_libraries.rst

Diagnostics: Warn about non-target directives

2026-07-28 11:38:20 -04:00

list.rst

Help: Move regex specification to cmake-language(7)

2026-09-07 10:17:42 -04: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: Clarify argument handling for macros

2026-02-02 10:36:59 -05:00

make_directory.rst

Help: Use CMake highlighting for command synopsis

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

mark_as_advanced.rst

Help: Replace some versionadded directives with versionchanged

2020-11-12 09:44:01 +05:00

math.rst

math(): Add INCREMENT and DECREMENT modes

2026-07-15 11:40:07 -04:00

message.rst

Diagnostics: Handle CMAKE_{WARN,ERROR}_DEPRECATED

2026-05-07 11:07:27 -04:00

option.rst

CMakeDependentOption: Sync documentation

2025-05-12 21:10:29 +02:00

output_required_files.rst

Help: Use CMake highlighting for command synopsis

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

project.rst

Help: Format list of supported languages as a definition list

2026-04-22 14:35:04 -04:00

qt_wrap_cpp.rst

Autogen: Replace documentation links with their permanent redirects

2025-05-28 11:11:20 -04:00

qt_wrap_ui.rst

qt_wrap_*: Add deprecation notes to command docs

2019-01-16 08:08:38 +11:00

remove_definitions.rst

remove_definitions: Update documentation

2025-10-21 22:23:15 +02:00

remove.rst

Help: Use CMake highlighting for command synopsis

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

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

Add support of custom rules

2026-09-20 11:43:10 +02:00

set_source_files_properties.rst

Help: Remove accidental blockquotes around lists

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

set_target_properties.rst

ALIAS: Add support for set_property and set_target_properties commands

2026-07-07 07:32:27 -07: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

set/unset commands: add CACHE{variable} syntax support

2025-08-04 20:46:23 +02:00

site_name.rst

Help: Document site_name command use of HOSTNAME variable

2020-10-22 10:20:43 -04:00

source_group.rst

Help/command/source_group: Clarify when file set support was added

2026-10-12 11:43:48 -04:00

string.rst

Help: Move regex specification to cmake-language(7)

2026-09-07 10:17:42 -04:00

subdir_depends.rst

Help: Use CMake highlighting for command synopsis

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

subdirs.rst

Help: Remove stray spaces and one colon

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

target_compile_definitions.rst

ALIAS: Add support for target_* commands

2026-07-08 11:51:50 -04:00

target_compile_features.rst

Help: Factor out "may use generator expressions"

2026-10-13 11:46:56 -04:00

target_compile_options.rst

ALIAS: Add support for target_* commands

2026-07-08 11:51:50 -04:00

target_include_directories.rst

ALIAS: Add support for target_* commands

2026-07-08 11:51:50 -04:00

target_link_directories.rst

ALIAS: Add support for target_* commands

2026-07-08 11:51:50 -04:00

target_link_libraries.rst

ALIAS: Add support for target_* commands

2026-07-08 11:51:50 -04:00

target_link_options.rst

ALIAS: Add support for target_* commands

2026-07-08 11:51:50 -04:00

target_precompile_headers.rst

Help: Factor out "may use generator expressions"

2026-10-13 11:46:56 -04:00

target_sources.rst

SYCL: Initial language implementation

2026-10-07 11:43:31 -04:00

try_compile.rst

SYCL: Initial language implementation

2026-10-07 11:43:31 -04:00

try_run.rst

Help: Improve command usage formatting consistency

2026-02-13 12:54:37 -05:00

unset.rst

set/unset commands: add CACHE{variable} syntax support

2025-08-04 20:46:23 +02:00

use_mangled_mesa.rst

Help: Use CMake highlighting for command synopsis

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

utility_source.rst

Help: Use CMake highlighting for command synopsis

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

variable_requires.rst

Help: Use CMake highlighting for command synopsis

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

variable_watch.rst

Help: Expand documentation of variable_watch()

2020-07-09 17:22:59 +02:00

while.rst

Help: Unindent _See Also_ related commands list

2022-11-07 22:55:06 +04:00

write_file.rst

Help: Use CMake highlighting for command synopsis

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