8000 Added docs for --input-file · log4cplus/Catch@840b99a · GitHub
[go: up one dir, main page]

Skip to content

Commit 840b99a

Browse files
committed
Added docs for --input-file
(somehow missing from previous commit)
1 parent 5259b78 commit 840b99a

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

docs/command-line.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -159,11 +159,19 @@ The ony available warning, presently, is ```NoAssertions```. This warning fails
159159

160160
When set to ```yes``` Catch will report the duration of each test case, in milliseconds. Note that it does this regardless of whether a test case passes or fails. Note, also, the certain reporters (e.g. Junit) always report test case durations regardless of this option being set or not.
161161

162+
<a id="input-file"></a>
163+
## Load test names to run from a file
164+
<pre>-f, --input-file &lt;filename></pre>
165+
166+
Provide the name of a file that contains a list of test case names - one per line. Blank lines are skipped and anything after the comment character, ```#```, is ignored.
167+
168+
A useful way to generate an initial instance of this file is to use the <a href="#list-test-names-only">list-test-names-only</a> option. This can then be manually curated to specify a specific subset of tests - or in a specific order.
169+
162170
<a id="list-test-names-only"></a>
163171
## Just test names
164172
<pre>--list-test-names-only</pre>
165173

166-
This option lists all available tests in a non-indented form, one on each line. This makes it ideal for saving to a file and feeding back into the <a href="#input-file">```-f``` or ```--input-file``` option</a>.
174+
This option lists all available tests in a non-indented form, one on each line. This makes it ideal for saving to a file and feeding back into the <a href="#input-file">```-f``` or ```--input-file```</a> option.
167175

168176

169177
<a id="order"></a>

0 commit comments

Comments
 (0)
0