summaryrefslogtreecommitdiffstats
path: root/Help/command
Commit message (Collapse)AuthorAgeFilesLines
* Merge topic 'no-smiley'Brad King2018-10-295-5/+5
|\ | | | | | | | | | | | | 24fa04018c Help: Spell out ";-list" as "semicolon-separated list" Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2528
| * Help: Spell out ";-list" as "semicolon-separated list"Joachim Wuttke (o)2018-10-255-5/+5
| |
* | Merge topic 'doc-updates'Brad King2018-10-263-4/+16
|\ \ | | | | | | | | | | | | | | | | | | 2f9c253961 Help: clarify "LINKER:" prefix usage Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2530
| * | Help: clarify "LINKER:" prefix usageMarc Chevrier2018-10-263-4/+16
| | | | | | | | | | | | Fixes: #18503
* | | Help: Back-reference from find_package() to "Find Modules"Joachim Wuttke (o)2018-10-251-2/+3
| | | | | | | | | | | | viz., to section "Find Modules" in cmake-modules.7
* | | Merge topic 'deprecation'Brad King2018-10-2516-16/+32
|\ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | c8e8c9cc7c Help: Date deprecation of deprecated commands. 19998d7b3c Help: Use 'deprecated' template, and date deprecation of modules dc1bb33578 Help: Add version number to deprecation note Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2523
| * | | Help: Date deprecation of deprecated commands.Joachim Wuttke (o)2018-10-2516-16/+32
| | |/ | |/|
* | | Help: Apply syntax highlighting to project commandsJoachim Wuttke (o)2018-10-2545-103/+108
|/ / | | | | | | | | | | * Replace most "::" by ".. code-block:: cmake" * Header sentence in imperative voice, detailed command description in present tense.
* | Merge topic 'scripting-commands'Brad King2018-10-2441-319/+472
|\ \ | | | | | | | | | | | | | | | | | | c2efb3efcd Help: Revise docs on Scripting Commands Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2504
| * | Help: Revise docs on Scripting CommandsJoachim Wuttke (l)2018-10-2341-319/+472
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revise docs for all "Scripting Commands", except four find_XXX that use a macro suite of their own. * Take full advantage of the improved syntax highlighting. * Make consequential use of <..> placeholders. * Clarify things here and there in the text. Specific improvements to some command docs: * "math": Correct description of novel hexadecimal capability. * "if", "foreach", "while": Provide link to "endif" etc * "foreach", "while": Mention "break" and "continue". * "foreach": Simplify explanation of ``RANGE`` and ``IN`` signatures; advise against negative arguments or reverse ranges (compare issue #18461) * "endif", "endfunction" etc: Explain that the argument is optional and maintained for compatibility only
* | | Merge topic 'doc-target_link_libraries-item-quoting'Brad King2018-10-191-0/+12
|\ \ \ | |/ / |/| | | | | | | | | | | | | | 18cff26e3a Help: Clarify command-line encoding of target_link_libraries items Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2503
| * | Help: Clarify command-line encoding of target_link_libraries itemsBrad King2018-10-181-0/+12
| | | | | | | | | | | | | | | | | | | | | | | | Items that have full paths will be quoted automatically. Other items are treated as command-line string fragments and get no automatic escaping. Document the behavior for each item kind. Fixes: #18467
| * | Merge branch 'doc-target_link_libraries-keywords-not-genex' into release-3.13Brad King2018-10-081-6/+18
| |\ \ | | | | | | | | | | | | Merge-request: !2449
| * \ \ Merge branch 'project-always-set-desc-url' into release-3.13Brad King2018-10-081-0/+2
| |\ \ \ | | | | | | | | | | | | | | | Merge-request: !2457
| * \ \ \ Merge branch 'list-SORT-docs' into release-3.13Brad King2018-10-081-11/+15
| |\ \ \ \ | | | | | | | | | | | | | | | | | | Merge-request: !2453
* | | | | | Help: Override pygments CMakeLexer to support <..> and [..]Joachim Wuttke (o)2018-10-181-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * The code snippets in the docs consist of CMake code mixed with syntax definition punctuation like < > [ ] ... Therefore a pure CMake lexer is inadequate. Here it is replaced by a CMake syntax definition parser. * Fixed syntax definition snippets in FindPkgConfig.cmake to make best use of syntax highlighting. This source file is the hardest to support because it contains comparison operators <= = >=, which need special attention to avoid confusion with the placeholder indicators <...>. * Fixed syntax in execute_process.rst (there were unbalanced brackets). * Disabled syntax highlighting for long string examples in cmake-language.7.rst. * No highlighting of removed syntax in CMP0049 * To inspect the outcome of this patch, see e.g. the pages * manual/cmake-buildsystem.7.html * module/ExternalProject.html * module/FindPkgConfig.html which are particularly rich in complex code snippets.
* | | | | | Merge branch 'backport-revert-install-code-script-genex' into ↵Brad King2018-10-111-4/+0
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | revert-install-code-script-genex
| * | | | | | install: Revert CODE,SCRIPT support for generator expressionsBrad King2018-10-111-4/+0
| | |_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Revert commit v3.13.0-rc1~441^2 (install: Teach CODE,SCRIPT modes to evaluate generator expressions, 2018-05-29). Unfortunately it has been found to break existing code in a real project, e.g. install(CODE [[ message("$<FOOBAR>") ]]) Address this regression by reverting support for the 3.13 release series. Support can be restored later with a policy for compatibility. Issue: #15785 Fixes: #18435
* | | | | | Merge topic 'ctest-done'Brad King2018-10-111-0/+1
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | a6e0158712 ctest_submit: Add support for a "Done" part f460bbd4c8 ctest_submit: Refactor file list to use a vector instead of a set Acked-by: Kitware Robot <kwrobot@kitware.com> Acked-by: Zack Galbreath <zack.galbreath@kitware.com> Merge-request: !2405
| * | | | | | ctest_submit: Add support for a "Done" partBetsy McPhail2018-10-101-0/+1
| |/ / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Teach CTest to submit Done.xml. Submission of this file indicates to CDash that a build is complete and no more files will be uploaded. It contains the build id returned by CDash and the current time. This file is submitted last for a given build when using the `ctest_submit()` command. If submitting by PARTS, use `ctest_submit(PARTS Done)`.
* | | | | | Merge topic 'project-version'Brad King2018-10-101-59/+88
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 2f43bd3b6c Help: move description of CMAKE_PROJECT_* variables e3e5445d83 Help: Describe options of command project in a definition list. 5b56795d57 Help: make the two signatures of command "project" orthogonal Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !2450
| * | | | | | Help: move description of CMAKE_PROJECT_* variablesJoachim Wuttke (o)2018-10-091-8/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Describe these variables along with the other variables.
| * | | | | | Help: Describe options of command project in a definition list.Joachim Wuttke (l)2018-10-091-51/+72
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Also add section headers; explain default setting of optional argument variables.
| * | | | | | Help: make the two signatures of command "project" orthogonalJoachim Wuttke (l)2018-10-091-1/+1
| | | | | | |
* | | | | | | Help: Make synopsis of if command more compact; add section headersJoachim Wuttke (l)2018-10-091-41/+49
|/ / / / / / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Also replace 'expression' by 'condition' (as in the while command); relegate optional arguments of else() and endif() to the text; revise explanation of operator precedence in Condition Syntax section.
* | | | | | Merge topic 'doc-regex-backslash'Brad King2018-10-091-6/+13
|\ \ \ \ \ \ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fab2c2339b Help: Fix documentation of escape sequences in a regex Acked-by: Kitware Robot <kwrobot@kitware.com> 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 topic 'doc-target_link_libraries-keywords-not-genex'Brad King2018-10-091-6/+18
|\ \ \ \ \ \ | | |_|_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | cd8c79e163 Help: Clarify target_link_libraries keywords and generator expressions Acked-by: Kitware Robot <kwrobot@kitware.com> 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 topic 'project-always-set-desc-url'Brad King2018-10-081-0/+2
|\ \ \ \ \ | | |_|_|/ | |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | f8a086a86b project(): Ensure DESCRIPTION and HOMEPAGE_URL variables are set b27247c8df project(): Add tests verifying variables set by second project() call Acked-by: Kitware Robot <kwrobot@kitware.com> 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 topic 'list-SORT-docs'Brad King2018-10-081-11/+15
|\ \ \ \ | |_|/ / |/| | / | | |/ | |/| | | | | | | cdf8d79e9f Help: Improve/fix incorrect docs for list(SORT) sub-options Acked-by: Kitware Robot <kwrobot@kitware.com> 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.
generated by cgit v0.12 at 2025-01-09 12:39:29 (GMT)