summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'doc-set_target_properties-clarify'Brad King2018-03-191-2/+4
|\ | | | | | | | | | | | | | | 89ee7ce3ea Help: Reference set_property from set_target_properties c27e3e0f2b Help: Clarify that set_target_properties supports multiple targets Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1866
| * Help: Reference set_property from set_target_propertiesBrad King2018-03-191-0/+2
| |
| * Help: Clarify that set_target_properties supports multiple targetsBrad King2018-03-191-2/+2
| | | | | | | | Reported-by: Alan W. Irwin <irwin@beluga.phys.uvic.ca>
* | Merge topic 'find-package_root-restore'Brad King2018-03-196-14/+50
|\ \ | | | | | | | | | | | | | | | | | | eb35d8884b find_package: Use PackageName_ROOT variables as search prefixes Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1858
| * | find_package: Use PackageName_ROOT variables as search prefixesBrad King2018-03-166-14/+50
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This feature was originally added by commit v3.9.0-rc1~71^2~2 (find_*: Add a new PackageRoot search path group, 2017-05-03) and documented by commit v3.9.0-rc1~71^2 (find_*: Add docs for PackageRoot search path group, 2017-05-03). However, we had to disable the feature and remove the documentation in commit v3.9.1~2^2 (find_*: Disable the PACKAGE_ROOT search path group for CMake 3.9, 2017-08-08) due to breaking projects that used `PackageName_ROOT` variables themselves. Add policy `CMP0074` to restore the `PackageName_ROOT` variable behavior in a compatible way. Also revise the stack of root paths to store the paths themselves rather than the package names. This way the policy can be considered at the `find_package` call site instead of individual `find_` calls inside a find module. Co-Author: Chuck Atkins <chuck.atkins@kitware.com> Issue: #17144
* | | Merge topic 'doc-list-command'Brad King2018-03-191-43/+126
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | 81226c73a4 Help: refresh list() command documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1860
| * | Help: refresh list() command documentationMarc Chevrier2018-03-161-43/+126
| |/ | | | | | | | | Reformat `list` command documentation be consistent with the `string` command.
* | Merge topic 'project-homepage-url'Craig Scott2018-03-171-6/+17
|\ \ | |/ |/| | | | | | | | | | | | | | | 73f9b2974c project: Add HOMEPAGE_URL named parameter fd28c382b4 project: Add <PROJECT-NAME>_DESCRIPTION 9b57cb62ea Help: Fix minor typo in docs for CMAKE_PROJECT_DESCRIPTION c89993d529 Tests: Avoid enabling languages unnecessarily in RunCMake.project Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1816
| * project: Add HOMEPAGE_URL named parameterAlex Turbov2018-03-161-3/+13
| | | | | | | | | | | | | | | | | | This sets variables like PROJECT_HOMEPAGE_URL, which can be used as default values for various things (packaging modules, doxygen defaults, etc.). Some packaging modules have been updated to do this as part of this commit. Co-Author: Craig Scott <craig.scott@crascit.com>
| * project: Add <PROJECT-NAME>_DESCRIPTIONCraig Scott2018-03-161-3/+4
| | | | | | | | For consistency with the VERSION keyword, also define the <PROJECT-NAME>_DESCRIPTION variable.
* | Merge topic 'compile-options-shell'Brad King2018-03-153-0/+13
|\ \ | |/ |/| | | | | | | | | ce0b983216 target_compile_options: Add syntax to specify shell strings Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1841
| * target_compile_options: Add syntax to specify shell stringsBrad King2018-03-143-0/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Options specified via `COMPILE_OPTIONS` and `INTERFACE_COMPILE_OPTIONS` are deduplicated, but individual options can legitimately be duplicated when grouped with other options, e.g. -D A -D B After deduplication that becomes `-D A B`. Therefore we need a way to treat groups of options as units during deduplication. A simple approach is to specify each group as one option, e.g. "-D A" "-D B" However, that conflicts with options that legitimately have spaces. To break this ambiguity, add a `SHELL:` prefix syntax to specify that an option should be parsed like shell command line arguments after deduplication, e.g. "SHELL:-D A" "SHELL:-D B" These will survive deduplication intact, and then be parsed to produce `-D A -D B` on the final command line. Fixes: #15826
* | Help: Fix incorrect CMAKE_PROJECT_xxx docsCraig Scott2018-03-131-2/+5
|/ | | | | | | | | The docs for CMAKE_PROJECT_NAME and CMAKE_PROJECT_DESCRIPTION were erroneously documenting the behavior of PROJECT_NAME and PROJECT_DESCRIPTION respectively. Fix these and update the project() docs to also mention CMAKE_PROJECT_NAME and CMAKE_PROJECT_DESCRIPTION. Fixes: #17815
* Help: Document linking behavior of OBJECT librariesBrad King2018-03-014-5/+73
| | | | | Inspired-by: Deniz Bahadir <dbahadir@benocs.com> Issue: #14778
* Merge topic 'object-library-export-as-interface'Brad King2018-03-012-0/+12
|\ | | | | | | | | | | | | ea0ce73a19 install,export: Maybe transform OBJECT libraries to INTERFACE libraries Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1811
| * install,export: Maybe transform OBJECT libraries to INTERFACE librariesBrad King2018-02-282-0/+12
| | | | | | | | | | | | | | | | | | | | | | Teach the `install` and `export` commands to support installing and exporting `OBJECT` libraries without their object files. Transform them to `INTERFACE` libraries in such cases. For `install(TARGETS)`, activate this when no destination for the object files is specified. For `export`, activate this only under Xcode with multiple architectures when we have no well-defined object file locations to give to clients.
* | Merge topic 'string-join'Brad King2018-02-201-0/+10
|\ \ | | | | | | | | | | | | | | | | | | | | | 689eeb67 string: Add JOIN subcommand Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Pavel Solodovnikov <hellyeahdominate@gmail.com> Merge-request: !1762
| * | string: Add JOIN subcommandAlex Turbov2018-02-161-0/+10
| |/ | | | | | | | | This is just like CONCAT but accepts a glue string to put between each value. `JOIN ""` is equivalent to `CONCAT`.
* | Adds file(TOUCH) and file(TOUCH_NOCREATE) sub-commandsShane Parris2018-02-151-0/+17
| |
* | Help: Expand string(MAKE_C_IDENTIFIER) docsCraig Scott2018-02-111-7/+12
|/ | | | | The MAKE_C_IDENTIFIER subcommand was also buried in the docs for the TIMESTAMP subcommand, so it has been pulled out to its own subheading.
* Help: Fix code example in cmake_parse_arguments.rstKai Wolf2018-02-041-1/+1
|
* Help: Better explain that foreach(RANGE ) is inclusive.Robert Maynard2018-01-291-4/+4
|
* Help: Improved MAIN_DEPENDENCY documentation of add_custom_command()Christoph Ruediger2018-01-161-2/+4
|
* Help: improve install() documentation of argument orderingKyle Edwards2018-01-081-1/+15
| | | | Fixes #16362.
* Merge topic 'execute_process_UTF8_keyword'Brad King2018-01-081-2/+4
|\ | | | | | | | | | | | | | | 8caec41e execute_process: Allow UTF-8 as a synonym for the UTF8 keyword Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Ben Boeckel <ben.boeckel@kitware.com> Merge-request: !1623
| * execute_process: Allow UTF-8 as a synonym for the UTF8 keywordCraig Scott2017-12-271-2/+4
| | | | | | | | | | | | | | | | UTF-8 is the proper naming according to the UTF-8 RFC and is also the name used for a similar keyword in the file() command. This commit brings (backward compatible) consistency to the keyword names and allows the standard UTF-8 name to be used with execute_process(). The old UTF8 keyword is still supported.
* | Various typo fixesLuz Paz2018-01-032-2/+2
|/ | | | Some are user-facing. Others are source comments.
* Help: Document that ASM should be enabled lastBrad King2017-12-062-2/+9
| | | | | | | ASM should be enabled after C and/or CXX because we consider the compilers for those languages as possible assemblers. Issue: #17532
* add_library: mention that Xcode requires a real source fileBen Boeckel2017-12-011-3/+3
| | | | | | | The docs mentioned that it happened, but not when. Mention Xcode since it is the culprit today. See #16524.
* Fix trivial typos in textluzpaz2017-11-033-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | Some are user facing. Found using codespell -q 3 --skip="./Utilities" -I .cmake-whitelist.txt` whereby the whitelist contained: ans dum helpfull emmited emmitted buil iff isnt nto ot pathes substract te todays upto whitespaces
* Merge topic 'cross_link_CheckLanguage_enable_language'Craig Scott2017-11-021-1/+2
|\ | | | | | | | | | | | | e2601534 Help: enable_language now documents the CheckLanguage module Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1434
| * Help: enable_language now documents the CheckLanguage moduleRobert Maynard2017-10-311-1/+2
| | | | | | | | Resolves #17409
* | Add support for IMPORTED GLOBAL targets to be aliasedDeniz Bahadir2017-10-262-3/+5
| | | | | | | | | | Issue: #15569 Issue: #17197
* | Teach target_* commands to set INTERFACE properties of IMPORTED targetsDeniz Bahadir2017-10-266-19/+26
| | | | | | | | | | | | | | | | | | | | | | Now, several `INTERFACE_*` properties can be set on `IMPORTED` targets, not only via `set_property` and `set_target_properties` but also via `target_compile_definitions`, `target_compile_features`, `target_compile_options`, `target_include_directories`, `target_sources` and `target_link_libraries`. Fixes: #15689 Issue: #17197
* | Merge topic 'defer-target-source-check'Brad King2017-10-252-11/+13
|\ \ | | | | | | | | | | | | | | | | | | | | | 4e7f6738 Defer check for sources within a target until generation. 6e4e7c65 Tests: Exclude bad RunCMake.add_executable case on multi-arch Xcode Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1242
| * | Defer check for sources within a target until generation.Deniz Bahadir2017-10-242-11/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The `add_library` and `add_executable` commands can now be called with no source-files and won't generate a warning or error message, as long as source-files will be added later via the `target_sources` command. If during the generation step still no sources are associated with targets created by such calls a useful error message will be generated and generation fails. Targets of type `INTERFACE_LIBRARY`, `UTILITY` or `GLOBAL_TARGET` are excluded from this check because we do not need sources for these target types during generation. Fixes: #16872
* | | Merge topic 'help_parse_arguments'Brad King2017-10-241-10/+13
|\ \ \ | |/ / |/| / | |/ | | | | | | 546a3289 Help: Fix cmake_parse_arguments behavior for not found arguments Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1397
| * Help: Fix cmake_parse_arguments behavior for not found argumentsSylvain Joubert2017-10-201-10/+13
| | | | | | | | | | Value keywords are actually UNDEFINED rather than set to the empty string when they are not found in the argument list.
* | file(DOWNLOAD|UPLOAD): Add 'NETRC' and 'NETRC_FILE' suboptionShane Parris2017-10-181-0/+25
|/
* Merge topic 'vs_improve_custom_command'Brad King2017-09-111-0/+10
|\ | | | | | | | | | | | | | | 9ed24280 VS: only add custom command line if it is not empty 34c4108b add HasOnlyEmptyCommandLines() method to cmCustomCommandGenerator Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1050
| * VS: only add custom command line if it is not emptyMichael Stürmer2017-09-041-0/+10
| |
* | Timestamp: support %A and %BBernhard M. Wiedemann2017-09-071-0/+2
|/ | | | | | | | These are defined both by [1] and [2] to give full names of a weekday and month. [1] http://pubs.opengroup.org/onlinepubs/009695399/functions/strftime.html [2] https://msdn.microsoft.com/de-de/library/fe06s4ak.aspx
* Help: Fix formatting typo for the 'if' commandSylvain Joubert2017-08-181-1/+1
|
* Add PREPEND sub-command to string commandSylvain Joubert2017-08-111-0/+9
|
* Merge topic 'find-package_root-disable'Brad King2017-08-106-48/+14
|\ | | | | | | | | | | | | 578d95f8 find_*: Disable the PACKAGE_ROOT search path group for CMake 3.9 Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1116
| * find_*: Disable the PACKAGE_ROOT search path group for CMake 3.9Brad King2017-08-086-48/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Disable the feature added by commit v3.9.0-rc1~71^2~2 (find_*: Add a new PackageRoot search path group, 2017-05-03) and remove documentation added by commit v3.9.0-rc1~71^2 (find_*: Add docs for PackageRoot search path group, 2017-05-03). Unfortunately the name `<pkg>_ROOT` may already be set by projects for their own incompatible purposes. Disable the behavior change for now to fix the regression for CMake 3.9. We can restore it later with a policy. In order to keep the implementation and tests working, add an undocumented variable we can use in the tests to enable the behavior before the policy is introduced. Fixes: #17144
* | Merge topic 'file_WRITE_docs'Brad King2017-08-041-2/+5
|\ \ | | | | | | | | | | | | | | | | | | d7472bbf file: Clarify directory creation behavior when using WRITE Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1088
| * | file: Clarify directory creation behavior when using WRITERobert Dailey2017-08-031-2/+5
| |/ | | | | | | | | | | | | When using `file(WRITE)`, parent directories are also created. Documentation has been updated to explain this behavior. Co-Author: Craig Scott <craig.scott@crascit.com>
* | Help: Document that file(GLOB) result is sortedRuslan Baratov2017-08-031-3/+1
| | | | | | | | | | | | | | It has been sorted since commit v3.6.0-rc1~54^2 (file: Sort GLOB results to make it deterministic, 2016-05-14). That commit left the order unspecified in the documentation, but has been stable long enough to document now.
* | Merge topic 'doc_configure_file'Brad King2017-07-112-2/+4
|\ \ | | | | | | | | | | | | | | | | | | c7d81e16 Help: Explicitly state that some file generations are lazy Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1025