summaryrefslogtreecommitdiffstats
path: root/Help/command/add_test.rst
Commit message (Collapse)AuthorAgeFilesLines
* 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.
* Help: Add `.. versionadded` directives to commands documentationNikita Nemkin2020-11-091-0/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This change ony concerns directives that appear in the document body. The guidelines for inserting version directives: * Baseline version is CMake 3.0, i.e. directives start at 3.1. * Always use `.. versionadded::` directive, avoid ad-hoc version references. Exception: policy pages. * For new command signatures, put `versionadded` on a separate line after the signature. * For a group of new signatures in a new document section, a single version note at the beginning of the section is sufficient. * For new options, put `versionadded` on a separate line before option description. * If all the option descriptions in the list are short one-liners, it's fine to put `versionadded` on the same line as the description. * If multiple option descriptions in close proximity would have the same ..versionadded directive, consider adding a single directive after the list, mentioning all added options. * For compact value lists and sub-option lists, put a single `versionadded` directive after the list mentioning all additions. * When a change is described in a single paragraph, put `versionadded` into that paragraph. * When only part of the paragraph has changed, separate the changed part if it doesn't break the flow. Otherwise, write a follow-up clarification paragraph and apply version directive to that. * When multiple version directives are close by, order earlier additions before later additions. * Indent related lists and code blocks to include them in the scope of `versionadded` directive. Issue: #19715
* add_test: Allow special characters in test name (w/ policy CMP0110)Deniz Bahadir2020-08-121-2/+3
| | | | | | | | | | | | | | Restore the change from commit f84af8e270 (add_test: Allow special characters in test name, 2020-05-16, v3.18.0-rc1~142^2) that had to be reverted by commit f84af8e270 (add_test: Allow special characters in test name, 2020-05-16, v3.18.0-rc1~142^2) for compatibility. Add policy CMP0110 to make the change in a compatible way. Also, support even more characters than before by generating the test scripts using bracket arguments around the test names. Fixes: #19391 Signed-off-by: Deniz Bahadir <dbahadir@benocs.com>
* add_test: Revert "Allow special characters in test name"Brad King2020-07-271-3/+2
| | | | | | | | | | | | Revert commit f84af8e270 (add_test: Allow special characters in test name, 2020-05-16, v3.18.0-rc1~142^2). Unfortunately the fix breaks projects that were working around the limitation with manual escaping. The fix can be re-introduced with a policy in a future version. Also add a 3.18.1 release note explaining the change. Fixes: #21017, #20965 Issue: #19391
* add_test: Allow special characters in test nameDeniz Bahadir2020-05-171-2/+3
| | | | Fixes: #19391
* Help: Add documentation for SKIP_REGULAR_EXPRESSION test propertyGabor Bencze2019-07-181-2/+3
|
* add_test: Add COMMAND_EXPAND_LISTS optionSergey Bobrenok2019-06-071-1/+7
| | | | | | | | | Add a `COMMAND_EXPAND_LISTS` option to the `add_test` command to cause `;`-separated lists produced by generator expressions to be expanded into multiple arguments. The `add_custom_command` command already has such an option. Fixes: #17284
* Help: for command enable_testing, explain relation to module CTest.Joachim Wuttke (o)2019-03-071-1/+2
|
* Help: Apply syntax highlighting to project commandsJoachim Wuttke (o)2018-10-251-4/+6
| | | | | | * Replace most "::" by ".. code-block:: cmake" * Header sentence in imperative voice, detailed command description in present tense.
* Help: Document add_test expectations of test command (#15798)Brad King2015-10-191-0/+7
|
* Help: Revise and format add_test() command documentationBrad King2014-02-201-48/+38
| | | | | Favor the add_test(NAME) signature and document the limitations of the plain signature.
* Help: Use ``inline-literals`` to mark generator expressions.Stephen Kelly2014-02-061-1/+1
|
* Help: Factor out cmake-generator-expressions manual pageBrad King2013-10-161-51/+3
| | | | | | | | | Generator expressions are supported in many places and are a distinct concept worthy of their own manual page. The old builtin documentation was previously represented by preprocessor macros to generate it into each place that supports them. Factor out the duplicate content into a dedicated cmake-generator-expressions manual page and reference it from each original location.
* Convert builtin help to reStructuredText source filesKitware Robot2013-10-151-0/+117
Run the convert-help.bash script to convert documentation: ./convert-help.bash "/path/to/CMake-build/bin" Then remove it.