summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-if-IS_ABSOLUTE'Brad King2021-04-202-2/+12
|\ | | | | | | | | | | | | | | 6234afdff4 Help: Document special cases for if(IS_ABSOLUTE) 789307b02f Help: Behavior of file(TO_NATIVE_PATH) depends on the host platform Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !6016
| * Help: Document special cases for if(IS_ABSOLUTE)Craig Scott2021-04-171-1/+10
| | | | | | | | | | | | | | The meaning of "absolute path" was previously assumed knowledge, but a number of special cases were left unspecified. The way some of these are handled differs to the way that cmake_path(IS_ABSOLUTE) works, so document those special cases so that the differing behavior between these two commands is clearly defined.
| * Help: Behavior of file(TO_NATIVE_PATH) depends on the host platformCraig Scott2021-04-171-1/+2
| |
* | Xcode: Add support of DEPFILE for add_custom_commandMarc Chevrier2021-04-151-10/+20
| | | | | | | | Issue: #20286
* | Genex: add_custom_command: DEPFILE supports genexMarc Chevrier2021-04-121-1/+6
| | | | | | | | | | | | This facility is very useful for 'Ninja Multi-Config' and required as well for future support of DEPFILE in 'Xcode' and 'Visual Studio' generators (#20286).
* | Merge topic 'doc-imported-soname'Brad King2021-04-051-6/+18
|\ \ | |/ | | | | | | | | | | 4d6e899578 Help: Document in add_library how to import libraries with SONAME Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5975
| * Help: Document in add_library how to import libraries with SONAMEBrad King2021-04-021-6/+18
| | | | | | | | | | | | | | | | | | | | When using `add_library` to create an `IMPORTED` library target, there are a few target properties that are essential to correctly tell CMake about the library file. We already cover `IMPORTED_LOCATION` and `IMPORTED_IMPLIB`. Add `IMPORTED_SONAME` and `IMPORTED_NO_SONAME`, which are important in certain cases. Fixes: #22016
| * Merge topic 'commands-file-permissions' into release-3.20Brad King2021-03-292-23/+40
| |\ | | | | | | | | | | | | | | | | | | | | | | | | | | | 769ff05483 Help: Clarify permission-related command options 900184616a Cleanup: Fix misspelt name of local C++ variable 635431a0c9 Tests: Check host platform instead of target for running stat 4ceb0ca59e Tests: Remove redundant files for configure_file() tests Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5945
* | \ Merge topic 'commands-file-permissions'Brad King2021-03-292-23/+40
|\ \ \ | | |/ | |/| | | | | | | | | | | | | | | | | | | | | | 769ff05483 Help: Clarify permission-related command options 900184616a Cleanup: Fix misspelt name of local C++ variable 635431a0c9 Tests: Check host platform instead of target for running stat 4ceb0ca59e Tests: Remove redundant files for configure_file() tests Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5945
| * | Help: Clarify permission-related command optionsCraig Scott2021-03-262-23/+40
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The previous docs did not make clear that at most only one of the three permissions-related options can be given for configure_file() or file(GENERATE) and that USE_SOURCE_PERMISSIONS is already the default behavior for these commands. Use consistent wording to refer to the input and output files for configure_file(). Add missing "versionadded" directives on some of these keywords. Use the consistent wording and keyword ordering between the configure_file(), file(GENERATE) and file(COPY) commands.
* | | project: Define variables indicating whether project is top levelfriendlyanon2021-03-261-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | Define `PROJECT_IS_TOP_LEVEL` and `<PROJECT-NAME>_IS_TOP_LEVEL`. The latter is a STATIC cache entry just like other `<PROJECT-NAME>_*` variables so that it is globally scoped. Issue: #20310 Fixes: #21961
* | | Help: Convert project() directory variables to a definition listBrad King2021-03-261-5/+6
| | |
* | | Merge topic 'doc-custom-output-genex'Brad King2021-03-252-3/+9
|\ \ \ | | |/ | |/| | | | | | | | | | | | | 2f59b683d3 Help: Custom OUTPUT and BYPRODUCTS genexes cannot refer to targets Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5939
| * | Help: Custom OUTPUT and BYPRODUCTS genexes cannot refer to targetsCraig Scott2021-03-252-3/+9
| |/ | | | | Relates: #21364
* | Help: Clarify configure_file #cmakedefine01 syntax and behaviorElsie Hupp2021-03-151-2/+24
| | | | | | | | Fixes: #21935
* | file: add `COPY_FILE` subcommandBen Boeckel2021-03-101-0/+23
| | | | | | | | | | | | The `file(COPY)` subcommand is overloaded and busy for such a simple operation. Instead, make a simpler subcommand with error handling support.
* | Find: Document that first argument to PATHS and HINTS can be ENV{}Robert Maynard2021-03-051-2/+2
| |
* | file(RENAME): Add option to not replace existing pathBrad King2021-03-041-1/+7
| | | | | | | | | | Add a `NO_REPLACE` option that prevents overwriting `<newname>` if it exists.
* | file(RENAME): Add option to capture error message on failureBrad King2021-03-041-2/+9
|/
* Help: Add internal links to if() docsMichael Hirsch, Ph.D2021-02-181-7/+51
|
* Help: Convert some genex names to explicit cross-referencesBrad King2021-02-053-6/+6
| | | | | | | | | Since commit c2dc7e0f53 (Help: Convert genex documentation to sphinx domain objects, 2021-01-15) we can use `:genex:` cross-references to link to named generator expressions. Update some places to do this. This is meant to demonstrate the capability, not as a comprehensive sweep.
* Merge topic 'doc-find-env-vars'Brad King2021-02-053-3/+6
|\ | | | | | | | | | | | | c40e81ce80 Help: Restore docs that find_library considers LIB, not INCLUDE Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5772
| * Help: Restore docs that find_library considers LIB, not INCLUDEBrad King2021-02-043-3/+6
| | | | | | | | | | | | | | | | | | | | Documentation updates in commit 02f527c66a (Find: Provide global controls for the `NO_[]_PATH` call options, 2019-06-12, v3.16.0-rc1~541^2) accidentally switched the `find_library` documentation to mention `INCLUDE` where it should be `LIB`. While at it, update `find_file` and `find_path` to mention `INCLUDE` and `PATH` in the order they are considered.
* | try_run: Allow to set working directoryAsit Dhal2021-02-031-0/+7
| | | | | | | | Fixes: #17634
* | Merge topic 'issue-19198'Brad King2021-02-021-1/+9
|\ \ | | | | | | | | | | | | | | | | | | | | | 255df8622b file(GENERATE): Support new line style Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Brad King <brad.king@kitware.com> Merge-request: !5649
| * | file(GENERATE): Support new line styleAsit Dhal2021-02-011-1/+9
| | | | | | | | | | | | Fixes: #19198
* | | Added `SETUID` and `SETGID` to the list of accepted file permissionswilliam.r.dieter2021-01-291-1/+1
|/ / | | | | | | Signed-off-by: william.r.dieter <william.r.dieter@intel.com>
* | cmake_path: rename 'GET ... RELATIVE_PATH' to 'GET ... RELATIVE_PART'Marc Chevrier2021-01-281-70/+49
| | | | | | | | | | | | | | For consistency, subcommand 'HAS_RELATIVE_PATH' is also renamed to 'HAS_RELATIVE_PART'. Fixes: #21385
* | Help: Document that if(EXISTS) does not expand ~Michael Hirsch, Ph.D2021-01-261-3/+4
| | | | | | | | Fixes: #21729
* | Help: Restructure and clarify cmake_path() docsCraig Scott2021-01-161-534/+523
| | | | | | Relates: #21385
* | Merge topic 'cmake_path-stabilization'Marc Chevrier2021-01-151-4/+3
|\ \ | | | | | | | | | | | | | | | | | | 76f0bcdfb6 cmake_path: various updates Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5695
| * | cmake_path: various updatesMarc Chevrier2021-01-131-4/+3
| | | | | | | | | | | | | | | | | | To follow discussions in #21385 and !5682: * Fix bug in cmCMakePath::IsSuffix() method * cmake_path(HASH) always normalized paths (NORMALIZE option removed)
* | | install(files): Support genex in rename optionAsit Dhal2021-01-131-0/+5
|/ / | | | | | | Fixes: #19903
* | Help: Add sections to if() conditions documentationShannon Booth2021-01-081-19/+35
| |
* | Makefiles: Add support of DEPFILE for add_custom_commandMarc Chevrier2020-12-231-3/+18
| | | | | | | | | | Issue: #20286 Fixes: #21415
* | Merge topic 'issue-20134'Brad King2020-12-221-3/+3
|\ \ | | | | | | | | | | | | | | | | | | b68699b717 target_include_directories: Support AFTER option Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5633
| * | target_include_directories: Support AFTER optionAsit Dhal2020-12-191-3/+3
| | | | | | | | | | | | Fixes: #20134
* | | Merge topic 'issue-15653'Brad King2020-12-221-1/+14
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | c3385dd8bd file(GENERATE): Support options to manipulate file permissions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5437
| * | | file(GENERATE): Support options to manipulate file permissionsAsit Dhal2020-12-211-1/+14
| |/ / | | | | | | | | | Fixes: #15653
* | | Help: replace deprecated $<CONFIGURATION> generator expressionNeroBurner2020-12-211-1/+1
|/ / | | | | | | | | The `$<CONFIGURATION>` genex has been deprecated since CMake 3.0. Use `$<CONFIG>` instead in the `add_test` example.
* | Ninja Multi-Config: Add support for cross-config custom commandsKyle Edwards2020-12-152-0/+18
| | | | | | | | Co-Author: Brad King <brad.king@kitware.com>
* | Help: Clarify version adding add_custom_{command,target} OUTPUT genex supportBrad King2020-12-152-34/+39
| | | | | | | | | | | | | | Update the documentation added by commit c257c25419 (add_custom_{command,target}: Add genex support to OUTPUT and BYPRODUCTS, 2020-10-19) to use sphinx markup instead of prose to specify the version in which the feature was added.
* | Merge topic 'custom-command-output-genex'Brad King2020-12-142-0/+89
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c257c25419 add_custom_{command,target}: Add genex support to OUTPUT and BYPRODUCTS f36af9228b cmLocalGenerator: Evaluate generator expressions in custom command outputs c887cefd9a cmLocalGenerator: Simplify custom command output cmSourceFile creation 947ba01bf9 cmLocalGenerator: Factor out helper to expand custom command output paths 1902d28ebc cmLocalGenerator: Refactor UpdateOutputToSourceMap to avoid boolean trap e4034eabe9 cmLocalGenerator: Re-order logic in CreateGeneratedSource 706c48301d cmCustomCommandGenerator: Treat relative outputs w.r.t. build dir 5d23c5446e cmCustomCommandGenerator: Refactor OUTPUT and DEPENDS path evaluation ... Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Kyle Edwards <kyle.edwards@kitware.com> Acked-by: Pavel Solodovnikov <hellyeahdominate@gmail.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !5402
| * | add_custom_{command,target}: Add genex support to OUTPUT and BYPRODUCTSBrad King2020-12-112-0/+51
| | | | | | | | | | | | | | | | | | | | | | | | | | | Move rejection of `#`, `<`, and `>` characters in outputs and byproducts to a generate-time check. This removes the front-end check that disallowed generator expressions. The generators have already been updated to handle them. Fixes: #12877
| * | Help: Add examples to add_custom_command reference documentationBrad King2020-12-101-0/+38
| | |
* | | Merge branch 'master' into doc-3_19_release-fixesBrad King2020-12-1160-437/+1825
|\ \ \ | |/ / | | / | |/ |/|
| * Help: Fix grammar in `.. versionadded` directivesNikita Nemkin2020-12-028-16/+17
| | | | | | | | Issue: #19715
| * Help: Fix version note for CMAKE_PROJECT_<PROJECT-NAME>_INCLUDENikita Nemkin2020-12-021-2/+3
| | | | | | | | | | | | This variable predates 3.0. Fixes: #21522
| * Help: Fix cmake_parse_arguments version noteNikita Nemkin2020-12-021-2/+4
| | | | | | | | Don't imply that cmake_parse_arguments() requires CMake 3.5+.
| * Merge topic 'compile_def_doc'Brad King2020-12-011-0/+9
| |\ | | | | | | | | | | | | | | | | | | 4b9fcadc9a Help: Describe definition values in target_compile_definitions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5547