summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* Merge branch 'doc-regex-backslash' into release-3.13Brad King2018-10-091-6/+13
|\ | | | | | | Merge-request: !2460
| * Help: Fix documentation of escape sequences in a regexBrad King2018-10-091-6/+13
| | | | | | | | | | | | | | | | | | | | Documentation added by commit 4b35dab891 (Help: Document how escape sequences work in a regex, 2018-07-18) is only correct for backslashes inside `[]` groups. The regex engine does interpret `\` escapes elsewhere. Fix the docs. Inspired-by: R2RT <artur.ryt@gmail.com> Fixes: #18428
* | Merge branch 'doc-target_link_libraries-keywords-not-genex' into release-3.13Brad King2018-10-081-6/+18
|\ \ | | | | | | | | | Merge-request: !2449
| * | Help: Clarify target_link_libraries keywords and generator expressionsBrad King2018-10-081-6/+18
| |/ | | | | | | | | | | | | | | | | | | The `optimized` and `debug` keyword items are meaningful only to the `target_link_libraries` command and have no meaning when produced by a generator expression. State this explicitly. Also recommend use of a quoted argument when the genex itself may contain a semicolon. Fixes: #18424
* | Merge branch 'project-always-set-desc-url' into release-3.13Brad King2018-10-081-0/+2
|\ \ | | | | | | | | | Merge-request: !2457
| * | project(): Ensure DESCRIPTION and HOMEPAGE_URL variables are setCraig Scott2018-10-071-0/+2
| |/ | | | | | | | | | | | | | | If a project() call does not have DESCRIPTION or HOMEPAGE_URL options, it must still set the relevant variables or else those variables will inherit values from an earlier project() call. That is inconsistent with how VERSION is handled and is likely to be unexpected. The docs were also ambiguous about what should happen in such cases.
* | Merge branch 'list-SORT-docs' into release-3.13Brad King2018-10-081-11/+15
|\ \ | | | | | | | | | Merge-request: !2453
| * | Help: Improve/fix incorrect docs for list(SORT) sub-optionsCraig Scott2018-10-061-11/+15
| |/
* | Help: Clarify find_package Module and Config mode relationJoachim Wuttke (l)2018-10-041-17/+17
| |
* | Help: Remove redundant recommendationBrad King2018-10-041-12/+4
| | | | | | | | | | We suggest that users prefer the basic signature in two places. Drop the latter and move its related content to a better section.
* | Help: Add internal section link to find_package command docsJoachim Wuttke (l)2018-10-041-6/+8
| |
* | Help: Add section headers to find_package commandJoachim Wuttke (l)2018-10-041-0/+15
| | | | | | | | | | The document is pretty long but is already mostly organized into sections. Add explicit section headers.
* | Help: Move find_package NO_POLICY_SCOPE to more appropriate locationJoachim Wuttke (l)2018-10-041-3/+3
| |
* | Help: Add table of contents to find_package command docsJoachim Wuttke (l)2018-10-041-0/+4
| |
* | Help: Rephrase summary in find_package command docsJoachim Wuttke (l)2018-10-041-1/+1
|/
* Help: Add note about CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONSKyle Edwards2018-10-011-0/+7
|
* Merge topic 'customcommandworkingdirectory'Brad King2018-09-282-0/+6
|\ | | | | | | | | | | | | f158ac19e1 add_custom_{command,target}: WORKING_DIRECTORY generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2409
| * add_custom_{command,target}: WORKING_DIRECTORY generator expressionsJon Chronopoulos2018-09-282-0/+6
| | | | | | | | | | | | | | This teaches add_custom_command and add_custom_target WORKING_DIRECTORY about generator expressions Fixes: #14089
* | link_directories(): enhance capabilitiesMarc Chevrier2018-09-251-1/+7
| |
* | LINK_DIRECTORIES: Add new properties and commandsMarc Chevrier2018-09-252-9/+90
|/ | | | | | | | | | | | These new capabilities enable to manage link directories Two new properties: * target properties: LINK_DIRECTORIES and INTERFACE_LINK_DIRECTORIES One new command * target_link_directories(): to populate target properties Fixes: #17215
* Help: Clarify handling of non-integer components in if() version testsCraig Scott2018-09-171-5/+15
|
* Merge topic 'out-of-dir-linking'Brad King2018-09-141-4/+7
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | a1ad0a699b target_link_libraries: Allow use with targets in other directories 9bbae5ae28 cmTarget: Future-proof AddLinkLibrary target lookup scope f9cb6f618a cmExportFileGenerator: Use cmGeneratorTarget::ResolveTargetReference 18441a6269 cmGeneratorTarget: Factor target name resolution out of link item resolution 2f708f5d65 Make internal TARGET_PROPERTY generator expressions more robust 94a75801c8 Android.mk: De-duplicate link libraries logic during export 8a63b23d16 cmGlobalGenerator: Remove unused FindLocalGenerator method Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Patrick Stotko <stotko@cs.uni-bonn.de> Merge-request: !2370
| * target_link_libraries: Allow use with targets in other directoriesBrad King2018-09-121-4/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Previously the command did not allow naming targets on the LHS that were not created in the calling directory. Lift this restriction to enable more flexible use by projects. Targets named on the RHS will need to be looked up during generation in the scope of the call site rather than the scope of the LHS target. Introduce an internal syntax in `[INTERFACE_]LINK_LIBRARIES` properties to specify target names that need to be looked up in a directory other than that containing the target on which the property is set. Add minimal documentation of the syntax to help users that encounter it. Unfortunately CMake previously did allow such calls in the case that only `INTERFACE` libraries are specified, but those libraries would be looked up in the target's directory rather than the caller's. Add policy `CMP0079` to enable the new behavior with new lookup scope in a compatible way. Fixes: #17943
* | Merge topic 'replace-os-x-name-with-macos'Brad King2018-09-114-8/+8
|\ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | ab2e35d614 Replace occurrences of "Mac OS X" with "macOS" in comments fc1602456a Help: Replace occurrences of "Mac OS X" with "macOS" Acked-by: Kitware Robot <kwrobot@kitware.com> Reviewed-by: Gregor Jasny <gjasny@googlemail.com> Reviewed-by: Clinton Stimpson <clinton@elemtech.com> Merge-request: !2351
| * | Help: Replace occurrences of "Mac OS X" with "macOS"Bartosz Kosiorek2018-09-054-8/+8
| | | | | | | | | | | | | | | | | | | | | | | | Apple's main Operating system changed their name from OS X to macOS: https://www.engadget.com/2016/06/13/os-x-is-now-macos/ Revise documentation accordingly.
* | | Merge topic 'docs/setdirproprs'Brad King2018-09-111-4/+3
|\ \ \ | |_|/ |/| | | | | | | | | | | | | | | | | 6d8cabe8d4 Help: Clarify INCLUDE_DIRECTORIES directory property behavior 7b9d8ce168 Help: Clarify wording of set_directory_properties docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2337
| * | Help: Clarify wording of set_directory_properties docsBrian Heim2018-09-101-4/+3
| |/
* | Help: Clarify cmake_host_system_information memory unitsTaylor Holberton2018-09-101-4/+8
|/ | | | | | The memory size query implementations report in units of one mebibyte (2^20). Clarify the unit in the documentation because "megabyte" might also be interpreted as 10^6.
* Help: Add CAPTURE_CMAKE_ERROR to ctest_submit and ctest_update documentationBetsy McPhail2018-08-292-1/+13
| | | | | Also, added CAPTURE_CMAKE_ERROR to vim synax file for ctest_submit, ctest_update and ctest_memcheck.
* Help: Document alternative to include_directoriesDavid Demelier2018-08-231-0/+6
| | | | | | Many existing tutorials suggest `include_directories` but that does not handle propagation to dependencies and such. Add a link to its documentation suggesting `target_include_directories` instead.
* Help: Clarify the unset commandRobert Maynard2018-08-211-3/+10
|
* Help: Add RETURN_VALUE as an option to ctest_submit(CDASH_UPLOADBetsy McPhail2018-08-151-2/+3
|
* Merge topic 'doc-consistently-reference-packagename'Craig Scott2018-08-152-42/+42
|\ | | | | | | | | | | | | 30d08bdce9 doc: Consistently use <PackageName> for describing the name of a package Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2283
| * doc: Consistently use <PackageName> for describing the name of a packageJean-Christophe Fillion-Robin2018-08-142-42/+42
| |
* | Help: Document when LINK_FLAGS and STATIC_LIBRARY_FLAGS are usedRobert Maynard2018-08-091-1/+1
|/
* Merge topic 'doc-find_package-root'Craig Scott2018-07-202-11/+19
|\ | | | | | | | | | | | | 492ade276b Help: Add explicit <PackageName>_ROOT variable documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2225
| * Help: Add explicit <PackageName>_ROOT variable documentationBrad King2018-07-202-11/+19
| | | | | | | | | | | | Add documentation for both the CMake variable and environment variable of this name pattern. Update references to these names to link to their documents. Clarify the pattern used to construct their names.
* | Help: Document how escape sequences work in a regexBrad King2018-07-181-0/+14
| | | | | | | | | | Our regex engine doesn't interpret `\`-escapes but CMake language escape sequences may be used to pass literal whitespace characters to it.
* | Merge topic 'doc-add_library-IMPORTED_OBJECTS'Brad King2018-07-161-2/+5
|\ \ | |/ | | | | | | | | | | 62b4df1e84 Help: Mention IMPORTED_OBJECTS in add_library docs Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2216
| * Help: Mention IMPORTED_OBJECTS in add_library docsBrad King2018-07-161-2/+5
| | | | | | | | | | | | | | The `IMPORTED_OBJECTS` is to object libraries as `IMPORTED_LOCATION` is to normal libraries. Fixes: #18176
| * Merge branch 'doc-add_compile_definitions' into release-3.12Brad King2018-07-051-3/+3
| |\ | | | | | | | | | Merge-request: !2192
| * \ Merge branch 'revert-subdirectory-linking' into release-3.12Brad King2018-07-031-1/+1
| |\ \ | | | | | | | | | | | | Merge-request: !2191
* | \ \ Merge topic 'option-normal-variable'Brad King2018-07-091-1/+3
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2a5f5c0e31 option: respect existing normal variable 12e6f83319 Option: Add a test that verifies interaction with normal variables 5bb3d40a28 cmOption: Remove VTK 4.0 workarounds Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2155
| * | | | option: respect existing normal variableRobert Maynard2018-07-091-1/+3
| | | | | | | | | | | | | | | | | | | | Add policy CMP0077 to change this behavior in a compatible way.
* | | | | Merge topic 'doc-add_compile_definitions'Brad King2018-07-051-3/+3
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | 89e3e62e13 Help: fix add_compile_definitions() documentation Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2192
| * | | | Help: fix add_compile_definitions() documentationMarc Chevrier2018-07-051-3/+3
| | | | | | | | | | | | | | | | | | | | Fixes: #18147
* | | | | Merge topic 'revert-subdirectory-linking'Brad King2018-07-051-1/+1
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | 0d7114987c Revert "target_link_libraries: Allow use with targets in other directories" Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2191
| * | | | Revert "target_link_libraries: Allow use with targets in other directories"Brad King2018-07-031-1/+1
| |/ / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit v3.12.0-rc1~82^2 (target_link_libraries: Allow use with targets in other directories, 2018-05-11). The RHS target scoping and visibility rules are not clear and will need further investigation before the feature can be added. Issue: #17943
* | | | Merge topic 'math-hex'Brad King2018-07-051-1/+17
|\ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 5dbee9d2d0 math: Add options to calculate and format output as hexadecimal 8661e7052c math: Diagnose divide-by-zero 7c4c13ffef math: Reject unexpected expression input explicitly 5b0f73a15a math: Use 64-bit integer type for computation 963b8d9f6c math: Add RunCMake.math test to prepare for error cases Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2056
| * | | | math: Add options to calculate and format output as hexadecimalDaniel Franke2018-07-031-1/+17
| | | | |