Skip to content

Commit b8dc4e3

Browse files
bajertomtherazix
authored andcommitted
Reduce text, added links to other sections
1 parent 0e7fc06 commit b8dc4e3

1 file changed

Lines changed: 19 additions & 44 deletions

File tree

docs/guide/execute-tests.inc.rst

Lines changed: 19 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -59,35 +59,17 @@ the execution is finished:
5959
tmt run --rm
6060
tmt run -r
6161
62-
63-
Access Test Logs
64-
------------------------------------------------------------------
65-
66-
If you do need to investigate test logs after running tests, use
67-
the ``-vv`` option to display full paths to log files, or ``-vvv``
68-
to show the complete test output directly in the terminal.
69-
70-
To see log paths or full output during the run, use ``-vv`` or
71-
``-vvv`` on the ``tmt run`` command:
72-
73-
.. code-block:: shell
74-
75-
# Show paths to test log files during the run
76-
$ tmt run -vv
77-
78-
# Show complete test output directly during the run
79-
$ tmt run -vvv
80-
81-
After the run is finished, use ``--last`` to access results from
82-
the most recent run without re-executing it:
62+
To investigate test logs during the run, use ``tmt run -vvv`` to
63+
see test progress and results (see :ref:`execute-progress` for
64+
details on verbosity levels). After the run is finished, review
65+
logs from the most recent run using the ``report`` step:
8366

8467
.. code-block:: shell
8568
86-
# Show paths to test log files from the last run
8769
$ tmt run --last report -vv
8870
89-
# Show complete test output from the last run
90-
$ tmt run --last report -vvv
71+
See :ref:`check-report` for more options including ``html``
72+
reports.
9173

9274

9375
Select Plans
@@ -238,6 +220,8 @@ some of them it is possible to use the ``--all`` option:
238220
tmt run --all provision --how=local
239221
240222
223+
.. _execute-progress:
224+
241225
Execute Progress
242226
------------------------------------------------------------------
243227

@@ -258,7 +242,7 @@ are printed:
258242

259243
.. code-block:: shell
260244
261-
$ tmt run --all execute -v
245+
$ tmt run -v
262246
263247
execute
264248
how: tmt
@@ -268,7 +252,7 @@ More verbose mode prints summary of the test being executed first:
268252

269253
.. code-block:: shell
270254
271-
$ tmt run --all execute -vv
255+
$ tmt run -vv
272256
273257
execute
274258
how: tmt
@@ -280,7 +264,7 @@ The most verbose mode prints also the test output:
280264

281265
.. code-block:: shell
282266
283-
$ tmt run --all execute -vvv
267+
$ tmt run -vvv
284268
285269
execute
286270
how: tmt
@@ -297,26 +281,17 @@ The most verbose mode prints also the test output:
297281
00:00:04 pass /tests/core/adjust [1/16]
298282
299283
284+
.. _check-report:
285+
300286
Check Report
301287
------------------------------------------------------------------
302288

303-
When a particular step is ``done``, it won't be executed
304-
repeatedly unless ``--force`` is used:
305-
306-
.. code-block:: shell
307-
308-
$ tmt run -l report --verbose
309-
/plans/features/core
310-
report
311-
status: done
312-
summary: 10 tests passed
313-
314-
If you need additional information about your already ``done``
315-
run use ``--force`` together with the ``--verbose`` option:
289+
To review results of your most recent run, use ``--last`` to
290+
access the ``report`` step without re-executing the whole run:
316291

317292
.. code-block:: shell
318293
319-
$ tmt run -l report -v --force
294+
$ tmt run --last report --verbose
320295
/plans/features/core
321296
report
322297
how: display
@@ -336,7 +311,7 @@ In order to investigate test logs raise verbosity even more:
336311

337312
.. code-block:: shell
338313
339-
$ tmt run -l report -vv --force
314+
$ tmt run -l report -vv
340315
/plans/features/core
341316
report
342317
how: display
@@ -358,8 +333,8 @@ it in your favorite web browser:
358333

359334
.. code-block:: shell
360335
361-
$ tmt run --last report --how html --open --force
362-
$ tmt run -l report -h html -of
336+
$ tmt run --last report --how html --open
337+
$ tmt run -l report -h html -o
363338
364339
365340
Provision Options

0 commit comments

Comments
 (0)