echo/CMake
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
5f2bf6ecc6
CMake/Help/command
History
Brad King 5f2bf6ecc6 Help: Drop misleading add_custom_command "makefile terms" explanation 
The "In makefile terms" explanation is left from very early days of
CMake to help developers migrating from hand-written makefiles.
These days it is often misinterpreted, particularly in the context
of multiple `add_custom_command` calls, to mean that we generate a
single Makefile containing rules for all custom commands.  This
leads to an incorrect mental model of the expressed build system.
The actual generated build system may spread the rules across multiple
targets that do not see the each other's file-level rules, which makes
target-level dependencies important too.
2022-12-07 18:39:37 -05:00
..
add_compile_definitions.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
add_compile_options.rst Help: Update compiler-specific add_compile_options() example and prose 2022-11-29 09:12:17 +11:00
add_custom_command.rst Help: Drop misleading add_custom_command "makefile terms" explanation 2022-12-07 18:39:37 -05:00
add_custom_target.rst add_custom_{command,target}: add genex support for COMMENT 2022-11-19 13:32:56 +01:00
add_definitions.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
add_dependencies.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
add_executable.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
add_library.rst Help: remove links from pages to themselves 2022-11-18 14:09:32 -05:00
add_link_options.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
add_subdirectory.rst Help: Clarify SYSTEM property default for imported targets 2022-12-05 19:42:06 -05:00
add_test.rst Help: Clarify when add_test and test properties support generator expressions 2022-03-21 15:46:50 -04:00
aux_source_directory.rst Help: Improve documentation links and formatting 2019-03-27 16:01:20 +01:00
block.rst Merge topic 'doc-improvements' 2022-11-10 10:11:22 -05:00
break.rst
build_command.rst Help: Add more CLI :option: references to various pages 2022-10-20 11:21:40 -04:00
build_name.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
cmake_host_system_information.rst Help: Use code-block:: cmake instead of :: for sub-commands descriptions 2022-11-07 22:55:07 +04:00
cmake_language.rst Add new flow-control commands for variables and policies scopes management 2022-08-22 16:25:53 +02:00
cmake_minimum_required.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
cmake_parse_arguments.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
cmake_path.rst Help: Use code-block:: cmake instead of :: for sub-commands descriptions 2022-11-07 22:55:07 +04:00
cmake_policy.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
configure_file.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
continue.rst Help: clean up and clarify block() and return() 2022-11-08 00:05:55 +11:00
create_test_sourcelist.rst Help: Apply syntax highlighting to project commands 2018-10-25 13:47:31 +02:00
ctest_build.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_configure.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_coverage.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_empty_binary_directory.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_memcheck.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_read_custom_files.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_run_script.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_sleep.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_start.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_submit.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_test.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_update.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
ctest_upload.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
define_property.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
DEVICE_LINK_OPTIONS.txt Help: Use direct refs to genexes instead of `$<GENEX-NAME>` 2022-11-09 23:52:30 +04:00
else.rst
elseif.rst
enable_language.rst Help: Document enable_language accepting multiple languages 2022-06-30 23:37:15 +02:00
enable_testing.rst Help: for command enable_testing, explain relation to module CTest. 2019-03-07 11:58:22 +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 Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
execute_process.rst Help: remove links from pages to themselves 2022-11-18 14:09:32 -05:00
export_library_dependencies.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
export.rst Help: Fix formatting of CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API notes 2022-08-09 13:05:34 -04:00
file.rst file(COPY_FILE): Add option to retry on Windows if input access fails 2022-11-17 15:05:07 -05:00
find_file.rst find_* commands: add control over Windows registry views 2022-04-29 22:00:02 +02:00
find_library.rst find_* commands: add control over Windows registry views 2022-04-29 22:00:02 +02:00
find_package.rst Help: Mention CMake version for a recently-added find_package search path 2022-10-20 11:17:46 -04:00
find_path.rst find_* commands: add control over Windows registry views 2022-04-29 22:00:02 +02:00
find_program.rst find_* commands: add control over Windows registry views 2022-04-29 22:00:02 +02:00
FIND_XXX_ORDER.txt
FIND_XXX_REGISTRY_VIEW.txt Help: Fix typos, grammar and formatting in CMP0134 policy docs 2022-08-30 15:11:09 -04:00
FIND_XXX_ROOT.txt
FIND_XXX.txt Help: Make VALIDATOR wording clearer and more precise 2022-11-07 23:51:51 +11:00
fltk_wrap_ui.rst Help: Apply syntax highlighting to project commands 2018-10-25 13:47:31 +02:00
foreach.rst Help: Unindent _See Also_ related commands list 2022-11-07 22:55:06 +04:00
function.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
GENEX_NOTE.txt Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
get_cmake_property.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04: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: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
get_property.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
get_source_file_property.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
get_target_property.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
get_test_property.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
if.rst Help: Unindent _See Also_ related commands list 2022-11-07 22:55:06 +04:00
include_directories.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
include_external_msproject.rst Help: Add .. versionadded directives to commands documentation 2020-11-09 20:51:57 +05:00
include_guard.rst Help: remove links from pages to themselves 2022-11-18 14:09:32 -05:00
include_regular_expression.rst Help: Apply syntax highlighting to project commands 2018-10-25 13:47:31 +02:00
include.rst
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 Help: remove links from pages to themselves 2022-11-18 14:09:32 -05:00
link_directories.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
link_libraries.rst Help: Apply syntax highlighting to project commands 2018-10-25 13:47:31 +02:00
LINK_OPTIONS_LINKER.txt Help: Add SHELL, LINKER and host/device discussions to property docs 2021-05-15 16:31:16 +10:00
list.rst Help: mention non-existent case for list(PREPEND) 2021-12-21 10:55:43 -05:00
load_cache.rst Help: Clarify load_cache documentation of first parameter 2019-11-01 10:00:28 -04:00
load_command.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
macro.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04: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 Help: Add .. versionadded directives to commands documentation 2020-11-09 20:51:57 +05:00
message.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
option.rst Help: Clarify that option() is a boolean 2022-07-05 11:05:54 -04:00
OPTIONS_SHELL.txt Help: Add SHELL, LINKER and host/device discussions to property docs 2021-05-15 16:31:16 +10:00
output_required_files.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
project.rst project: Warn at top-level if cmake_minimum_required wasn't called 2022-11-11 22:49:36 +01:00
qt_wrap_cpp.rst qt_wrap_*: Add deprecation notes to command docs 2019-01-16 08:08:38 +11:00
qt_wrap_ui.rst qt_wrap_*: Add deprecation notes to command docs 2019-01-16 08:08:38 +11:00
remove_definitions.rst Help: Apply syntax highlighting to project commands 2018-10-25 13:47:31 +02:00
remove.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
return.rst Help: remove links from pages to themselves 2022-11-18 14:09:32 -05:00
separate_arguments.rst Help: Add .. versionadded directives to commands documentation 2020-11-09 20:51:57 +05:00
set_directory_properties.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
set_property.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
set_source_files_properties.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
set_target_properties.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
set_tests_properties.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
set.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04: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: Clarify condition of tree command from source_group. 2021-06-23 17:24:09 +02:00
string.rst string(TIMESTAMP): Add %z and %Z for adding time zone string 2022-10-27 11:13:46 -04:00
subdir_depends.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
subdirs.rst Help: Use CMake highlighting for command synopsis 2022-11-09 23:52:30 +04:00
target_compile_definitions.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
target_compile_features.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
target_compile_options.rst Help: Clarify behavior of BEFORE with target_compile_options() 2022-11-27 20:35:14 +11:00
target_include_directories.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
target_link_directories.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
target_link_libraries.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
target_link_options.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
target_precompile_headers.rst Help: Move a note about arguments and genexes into include file 2022-11-09 23:52:30 +04:00
target_sources.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04:00
try_compile.rst Help: remove links from pages to themselves 2022-11-18 14:09:32 -05:00
try_run.rst Help: Fix typo that crashes older pygments lexers 2022-10-13 12:04:00 -04:00
unset.rst Help: Add _See Also_ sections to related CMake commands 2022-11-09 23:52:30 +04: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