@@ -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
9375Select 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+
241225Execute 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+
300286Check 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