Skip to content

Commit 11206e5

Browse files
committed
UG: Use 'Rebot' instead of 'rebot' when referring to Rebot tool, not command.
1 parent f6ef2f6 commit 11206e5

File tree

4 files changed

+26
-26
lines changed

4 files changed

+26
-26
lines changed

doc/userguide/src/ExecutingTestCases/BasicUsage.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Basic usage
44
Robot Framework test cases are executed from the command line, and the
55
end result is, by default, an `output file`_ in XML format and an HTML
66
report_ and log_. After the execution, output files can be combined and
7-
otherwise `post-processed`__ with the ``rebot`` tool.
7+
otherwise `post-processed`__ with the Rebot tool.
88

99
__ `Post-processing outputs`_
1010

@@ -228,7 +228,7 @@ post-processing`__, respectively. The options and their values must be
228228
defined as a space separated list and they are placed in front of any
229229
explicit options on the command line. The main use case for these
230230
environment variables is setting global default values for certain options to
231-
avoid the need to repeat them every time tests are run or ``rebot`` used.
231+
avoid the need to repeat them every time tests are run or Rebot used.
232232

233233
.. sourcecode:: bash
234234

@@ -324,7 +324,7 @@ the :option:`--NoStatusRC` command line option. This might be useful, for
324324
example, in continuous integration servers where post-processing of results
325325
is needed before the overall status of test execution can be determined.
326326

327-
.. note:: Same return codes are also used with rebot_.
327+
.. note:: Same return codes are also used with Rebot_.
328328

329329
Errors and warnings during execution
330330
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -533,8 +533,8 @@ another:
533533

534534
Implementing the above example with Windows batch files is not very
535535
complicated, either. The most important thing to remember is that
536-
because ``robot`` and ``rebot`` are implemented as batch
537-
files, ``call`` must be used when running them from another batch
536+
because ``robot`` and ``rebot`` scripts are implemented as batch files on
537+
Windows, ``call`` must be used when running them from another batch
538538
file. Otherwise execution would end when the first batch file is
539539
finished.
540540

doc/userguide/src/ExecutingTestCases/ConfiguringExecution.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Selecting test cases
1717

1818
Robot Framework offers several command line options for selecting
1919
which test cases to execute. The same options also work when
20-
post-processing outputs with the ``rebot`` tool.
20+
post-processing outputs with Rebot_.
2121

2222
By test suite and test case names
2323
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -155,10 +155,10 @@ also in this case. As a result normal outputs are created but show zero
155155
executed tests. The same option can be used also to alter the behavior when
156156
an empty directory or a test case file containing no tests is executed.
157157

158-
Similar situation can occur also when processing output files with rebot_.
158+
Similar situation can occur also when processing output files with Rebot_.
159159
It is possible that no test match the used filtering criteria or that
160160
the output file contained no tests to begin with. By default executing
161-
``rebot`` fails in these cases, but it has a separate
161+
Rebot fails in these cases, but it has a separate
162162
:option:`--ProcessEmptySuite` option that can be used to alter the behavior.
163163
In practice this option works the same way as :option:`--RunEmptySuite` when
164164
running tests.
@@ -205,7 +205,7 @@ they start to pass.
205205

206206
Criticality set when tests are
207207
executed is not stored anywhere. If you want to keep same criticality
208-
when `post-processing outputs`_ with ``rebot``, you need to
208+
when `post-processing outputs`_ with Rebot, you need to
209209
use :option:`--critical` and/or :option:`--noncritical` also with it::
210210

211211
# Use rebot to create new log and report from the output created during execution

doc/userguide/src/ExecutingTestCases/OutputFiles.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -267,11 +267,11 @@ threshold level. A special value `NONE` can also be used to
267267
disable logging altogether.
268268

269269
It is possible to use the :option:`--loglevel` option also when
270-
`post-processing outputs`_ with ``rebot``. This allows, for example,
270+
`post-processing outputs`_ with Rebot. This allows, for example,
271271
running tests initially with the `TRACE` level, and generating smaller
272272
log files for normal viewing later with the `INFO` level. By default
273273
all the messages included during execution will be included also with
274-
``rebot``. Messages ignored during the execution cannot be recovered.
274+
Rebot. Messages ignored during the execution cannot be recovered.
275275

276276
Another possibility to change the log level is using the BuiltIn_
277277
keyword :name:`Set Log Level` in the test data. It takes the same
@@ -556,15 +556,15 @@ deeply nested keyword structures.
556556
Setting start and end time of execution
557557
---------------------------------------
558558

559-
When `combining outputs`_ using ``rebot``, it is possible to set the start
559+
When `combining outputs`_ using Rebot, it is possible to set the start
560560
and end time of the combined test suite using the options :option:`--starttime`
561561
and :option:`--endtime`, respectively. This is convenient, because by default,
562562
combined suites do not have these values. When both the start and end time are
563563
given, the elapsed time is also calculated based on them. Otherwise the elapsed
564564
time is got by adding the elapsed times of the child test suites together.
565565

566566
It is also possible to use the above mentioned options to set start and end
567-
times for a single suite when using ``rebot``. Using these options with a
567+
times for a single suite when using Rebot. Using these options with a
568568
single output always affects the elapsed time of the suite.
569569

570570
Times must be given as timestamps in the format `YYYY-MM-DD

doc/userguide/src/ExecutingTestCases/PostProcessing.rst

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Post-processing outputs
44
=======================
55

66
`XML output files`_ that are generated during the test execution can be
7-
post-processed afterwards by the ``rebot`` tool, which is an integral
7+
post-processed afterwards by the Rebot tool, which is an integral
88
part of Robot Framework. It is used automatically when test
99
reports and logs are generated during the test execution, and using it
1010
separately allows creating custom reports and logs as well as combining
@@ -14,8 +14,8 @@ and merging results.
1414
:depth: 2
1515
:local:
1616

17-
Using ``rebot`` tool
18-
--------------------
17+
Using Rebot
18+
-----------
1919

2020
Synopsis
2121
~~~~~~~~
@@ -37,22 +37,22 @@ any interpreter, or use the `standalone JAR distribution`_.
3737
Specifying options and arguments
3838
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3939

40-
The basic syntax for using ``rebot`` is exactly the same as when
40+
The basic syntax for using Rebot is exactly the same as when
4141
`starting test execution`_ and also most of the command line options are
42-
identical. The main difference is that arguments to ``rebot`` are
42+
identical. The main difference is that arguments to Rebot are
4343
`XML output files`_ instead of test data files or directories.
4444

45-
Return codes with ``rebot``
46-
~~~~~~~~~~~~~~~~~~~~~~~~~~~
45+
Return codes with Rebot
46+
~~~~~~~~~~~~~~~~~~~~~~~
4747

48-
Return codes from ``rebot`` are exactly same as when `running tests`__.
48+
Return codes from Rebot are exactly same as when `running tests`__.
4949

5050
__ `Return codes`_
5151

5252
Creating different reports and logs
5353
-----------------------------------
5454

55-
You can use ``rebot`` for creating the same reports and logs that
55+
You can use Rebot for creating the same reports and logs that
5656
are created automatically during the test execution. Of course, it is
5757
not sensible to create the exactly same files, but, for example,
5858
having one report with all test cases and another with only some
@@ -69,12 +69,12 @@ for example, be executed on different environments, output files collected
6969
to a central place, and reports and logs created there. This approach can
7070
also work very well if generating reports and logs takes a lot of time when
7171
running tests on Jython. Disabling log and report generation and generating
72-
them later with ``rebot`` can save a lot of time and use less memory.
72+
them later with Rebot can save a lot of time and use less memory.
7373

7474
Combining outputs
7575
-----------------
7676

77-
An important feature in ``rebot`` is its ability to combine
77+
An important feature in Rebot is its ability to combine
7878
outputs from different test execution rounds. This capability allows,
7979
for example, running the same test cases on different environments and
8080
generating an overall report from all outputs. Combining outputs is
@@ -105,7 +105,7 @@ If same tests are re-executed or a single test suite executed in pieces,
105105
combining results like discussed above creates an unnecessary top-level
106106
test suite. In these cases it is typically better to merge results instead.
107107
Merging is done by using :option:`--merge` option which changes the way how
108-
``rebot`` combines two or more output files. This option itself takes no
108+
Rebot combines two or more output files. This option itself takes no
109109
arguments and all other command line options can be used with it normally::
110110

111111
rebot --merge --name Example --critical regression original.xml merged.xml
@@ -126,7 +126,7 @@ Combining re-execution results with the original results using the default
126126
`combining outputs`_ approach does not work too well. The main problem is
127127
that you get separate test suites and possibly already fixed failures are
128128
also shown. In this situation it is better to use :option:`--merge (-R)`
129-
option to tell ``rebot`` to merge the results instead. In practice this
129+
option to tell Rebot to merge the results instead. In practice this
130130
means that tests from the latter test runs replace tests in the original.
131131
The usage is best illustrated by a practical example using
132132
:option:`--rerunfailed` and :option:`--merge` together::

0 commit comments

Comments
 (0)