summaryrefslogtreecommitdiffstats
path: root/Help
Commit message (Collapse)AuthorAgeFilesLines
* find_package: Use PackageName_ROOT variables as search prefixesBrad King2018-03-169-14/+81
| | | | | | | | | | | | | | | | | | | 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 'compile-options-shell'Brad King2018-03-154-0/+19
|\ | | | | | | | | | | | | 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-144-0/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* | Merge topic 'cmake_project_xxx_docs'Brad King2018-03-145-10/+74
|\ \ | | | | | | | | | | | | | | | | | | 6a2a9d107d Help: Fix incorrect CMAKE_PROJECT_xxx docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1847
| * | Help: Fix incorrect CMAKE_PROJECT_xxx docsCraig Scott2018-03-135-10/+74
| | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* | | Merge topic 'build_and_test_mode_docs'Brad King2018-03-141-10/+14
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | 8b43adc45c Help: Clarify ctest build-and-test mode options Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1848
| * | | Help: Clarify ctest build-and-test mode optionsCraig Scott2018-03-131-10/+14
| |/ / | | | | | | Fixes: #17807
* | | Merge topic 'doc-vs-workdir-versions'Brad King2018-03-141-0/+3
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 4b25cc452a Help: Document VS_DEBUGGER_WORKING_DIRECTORY supported VS versions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1843
| * | Help: Document VS_DEBUGGER_WORKING_DIRECTORY supported VS versionsHannes Mezger2018-03-131-0/+3
| |/
* | Merge topic 'update-buildsystem-docs'Brad King2018-03-121-6/+5
|\ \ | | | | | | | | | | | | | | | | | | 78756429ab Help: Adapt cmake-buildsystem(7) to new IMPORTED targets features Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1839
| * | Help: Adapt cmake-buildsystem(7) to new IMPORTED targets featuresKai Wolf2018-03-121-6/+5
| | | | | | | | | | | | | | | | | | | | | Since commit v3.11.0-rc1~433^2~2 (Teach target_* commands to set INTERFACE properties of IMPORTED targets, 2017-09-18) it is now possible to use the customary `target_*` commands for adjusting the settings of an IMPORTED target. Update documentation accordingly.
| * | Merge branch 'autogen-depend-filters-documentation' into release-3.11Brad King2018-02-212-26/+99
| |\ \ | | | | | | | | | | | | Merge-request: !1782
| * \ \ Merge branch 'help_fixup' into release-3.11Brad King2018-02-162-2/+2
| |\ \ \ | | | | | | | | | | | | | | | Merge-request: !1770
* | \ \ \ Merge topic 'genex-TARGET_EXISTS'Brad King2018-03-122-0/+8
|\ \ \ \ \ | |_|_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | 7fec336bf7 genex: Add TARGET_EXISTS to check for target existence Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1829
| * | | | genex: Add TARGET_EXISTS to check for target existenceAlex Turbov2018-03-092-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | Define `$<TARGET_EXISTS:a>` to `1` if `a` is an existed target name, else `0`.
* | | | | FindLibXml2: provide imported target LibXml2::LibXml2Rolf Eike Beer2018-03-081-0/+4
| | | | |
* | | | | Merge topic 'curl-target'Brad King2018-03-081-0/+4
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ee06f3c339 FindCURL: Revise documentation markup 83c0cb3f03 FindCURL: provide imported target CURL::CURL Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1822
| * | | | | FindCURL: provide imported target CURL::CURLRolf Eike Beer2018-03-061-0/+4
| |/ / / /
* | | | | Merge topic 'avoid-LIB_DEPENDS'Brad King2018-03-083-0/+38
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 7723e9a058 Do not produce legacy _LIB_DEPENDS cache entries 2124a1364a cmTarget: Remove unnecessary RecordDependencies member 1c5bfab532 cmTarget: Simplify ClearDependencyInformation implementation 910a9d608e cmTarget: Simplify ClearDependencyInformation signature Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Pavel Solodovnikov <hellyeahdominate@gmail.com> Merge-request: !1828
| * | | | | Do not produce legacy _LIB_DEPENDS cache entriesBrad King2018-03-073-0/+38
| |/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | Introduce policy `CMP0073` to avoid producing these cache entries. Fixes: #16364
* | | | | CTest: Add options to control test process affinity to CPUsBrad King2018-03-054-0/+21
|/ / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In commit v2.8.0~170 (ENH: Added ctest test options PROCESSORS and RUN_SERIAL, 2009-09-07) CTest learned to track the number of processors allocated to running tests in order to balance it against the desired level of parallelism. Extend this idea by introducing a new `PROCESSOR_AFFINITY` test property to ask that CTest run a test with the CPU affinity mask set. This will allow a set of tests that are running concurrently to use disjoint CPU resources.
* | | | Help: Document linking behavior of OBJECT librariesBrad King2018-03-016-21/+104
| | | | | | | | | | | | | | | | | | | | 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.
* | | | | Help: Fix wrong default for WORKING_DIRECTORY test propertyCraig Scott2018-02-271-2/+4
| | | | |
* | | | | Document and extend the CMAKE_SUPPRESS_REGENERATION variableShane Parris2018-02-233-0/+18
| | | | | | | | | | | | | | | | | | | | Fixes: https://gitlab.kitware.com/cmake/cmake/issues/16815
* | | | | Merge topic 'autogen-depend-filters-documentation'Brad King2018-02-212-26/+99
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | bfffe42b Autogen: Doc: Extend AUTOMOC_DEPEND_FILTERS documentation 1cf7c54a Autogen: Doc: Extend AUTOGEN_TARGET_DEPENDS documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1782
| * | | | Autogen: Doc: Extend AUTOMOC_DEPEND_FILTERS documentationSebastian Holtermann2018-02-211-18/+77
| | | | |
| * | | | Autogen: Doc: Extend AUTOGEN_TARGET_DEPENDS documentationSebastian Holtermann2018-02-211-8/+22
| | | | |
* | | | | Merge topic 'string-join'Brad King2018-02-202-0/+15
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-162-0/+15
| | |/ / / | |/| | | | | | | | | | | | | | | | | | This is just like CONCAT but accepts a glue string to put between each value. `JOIN ""` is equivalent to `CONCAT`.
* | | | | Merge topic 'follow-up-misc-typos'Brad King2018-02-201-1/+1
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 287e7a17 Maint: misc. typos Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1771
| * | | | | Maint: misc. typosluz.paz2018-02-161-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | Found via `codespell`
* | | | | | Merge topic 'help_fixup'Brad King2018-02-202-2/+2
|\ \ \ \ \ \ | | |_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | 1667e244 Help: Fix command references in CMAKE_NETRC* variable documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1770
| * | | | | Help: Fix command references in CMAKE_NETRC* variable documentationShane Parris2018-02-162-2/+2
| | |_|/ / | |/| | |
* | | | | Merge topic 'file_cmd_touch'Brad King2018-02-162-0/+23
|\ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e78e24f6 Replaces execute_process calls to touch files with file(TOUCH) calls 602988e1 Adds file(TOUCH) and file(TOUCH_NOCREATE) sub-commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1705
| * | | | | Adds file(TOUCH) and file(TOUCH_NOCREATE) sub-commandsShane Parris2018-02-152-0/+23
| | |/ / / | |/| | |
* | | | | Merge topic 'genex-IN_LIST-operator'Brad King2018-02-162-0/+7
|\ \ \ \ \ | |/ / / / |/| | | | | | | | | | | | | | | | | | | | | | | | 5089f560 Genex: Add IN_LIST logical operator Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1724
| * | | | Genex: Add IN_LIST logical operatorMarc Chevrier2018-02-072-0/+7
| | |/ / | |/| | | | | | | | | | Implements #17679
* | | | Merge topic 'enhanced-UseSWIG-Module'Brad King2018-02-151-0/+6
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 0bef9eb4 UseSWIG: modernize module d6048bd1 UseSWIG: Re-work test framework Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1707
| * | | | UseSWIG: modernize moduleMarc Chevrier2018-02-141-0/+6
| |/ / /
* | | | Merge topic 'directory-property-TESTS'Brad King2018-02-153-0/+13
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | b513a879 Tests management: add TESTS directory property Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1748
| * | | | Tests management: add TESTS directory propertyMarc Chevrier2018-02-083-0/+13
| |/ / / | | | | | | | | | | | | Implements: #17680
* | | | Help: Expand string(MAKE_C_IDENTIFIER) docsCraig Scott2018-02-112-8/+14
|/ / / | | | | | | | | | | | | 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.
* | | Begin post-3.11 developmentBrad King2018-02-052-0/+9
| |/ |/|
* | Help: Drop development topic notes to prepare releaseBrad King2018-02-052-9/+0
|/ | | | | Release versions do not have the development topic section of the CMake Release Notes index page.
* Help: Organize and revise 3.11 release notesBrad King2018-02-051-159/+197
| | | | | Add section headers similar to the 3.10 release notes and move each individual bullet into an appropriate section. Revise a few bullets.
* Help: Consolidate 3.11 release notesBrad King2018-02-0540-308/+241
| | | | | Run the `Utilities/Release/consolidate-relnotes.bash` script to move notes from `Help/release/dev/*` into `Help/release/3.11.rst`.
* Merge topic 'fix_help_cmake_parse_arguments'Brad King2018-02-051-1/+1
|\ | | | | | | | | | | | | b95eda9b Help: Fix code example in cmake_parse_arguments.rst Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1747
| * Help: Fix code example in cmake_parse_arguments.rstKai Wolf2018-02-041-1/+1
| |