Revision: 3870
Author: pekka.klarck
Date: Mon Aug 23 07:16:42 2010
Log: explained --loglevel w/ rebot (issue 608)
http://code.google.com/p/robotframework/source/detail?r=3870
Modified:
/trunk/doc/userguide/src/Appendices/CommandLineOptions.txt
/trunk/doc/userguide/src/ExecutingTestCases/OutputFiles.txt
=======================================
--- /trunk/doc/userguide/src/Appendices/CommandLineOptions.txt Wed Jun 9
14:08:54 2010
+++ /trunk/doc/userguide/src/Appendices/CommandLineOptions.txt Mon Aug 23
07:16:42 2010
@@ -85,6 +85,7 @@
--reporttitle <title> `Sets a title`_ for the generated test report.
--reportbackground <colors> `Sets background colors`_ for the
generated report and summary.
--summarytitle <title> `Sets a title`_ for the generated summary report.
+ -L, --loglevel <level> `Sets the threshold level`_ to select log
messages. New in Robot Framework 2.5.2.
--suitestatlevel <level> Defines how many `levels to show`_ in
the :name:`Statistics by Suite`
table in outputs.
--tagstatinclude <tag> `Includes only these tags`_ in
the :name:`Statistics by Tag` and
=======================================
--- /trunk/doc/userguide/src/ExecutingTestCases/OutputFiles.txt Thu Jun 10
02:51:44 2010
+++ /trunk/doc/userguide/src/ExecutingTestCases/OutputFiles.txt Mon Aug 23
07:16:42 2010
@@ -240,13 +240,21 @@
Setting log level
'''''''''''''''''
-By default, log messages below :msg:`INFO` are not logged, but this
-threshold level can be changed from the command line using the
+By default, log messages below the :msg:`INFO` level are not logged, but
this
+threshold can be changed from the command line using the
:opt:`--loglevel (-L)` option. This option takes any of the
available log levels as an argument, and that level becomes the new
threshold level. A special value :msg:`NONE` can also be used to
disable logging altogether.
+Starting from Robot Framework 2.5.2, it is possible to use the
+:opt:`--loglevel` option also when `post-processing outputs`_ with
+:prog:`rebot`. This allows, for example, running tests initially with
+the :msg:`TRACE` level, and generating smaller log files for normal
+viewing later with the :msg:`INFO` level. By default all the messages
+included during execution will be included also with :prog:`rebot`.
+Messages ignored during the execution cannot be recovered.
+
Another possibility to change the log level is using the `BuiltIn
keyword`_ :name:`Set Log Level` in the test data. It takes the same
arguments as the :opt:`--loglevel` option, and it also returns the
