Revision: 6ede88064c71
Author: Janne Härkönen <[email protected]>
Date: Fri May 20 00:00:22 2011
Log: userguide: explain how output file can be disabled when running
Update issue 829
Status: Done
http://code.google.com/p/robotframework/source/detail?r=6ede88064c71
Modified:
/doc/userguide/RobotFrameworkUserGuide.html
/doc/userguide/src/ExecutingTestCases/OutputFiles.txt
=======================================
--- /doc/userguide/RobotFrameworkUserGuide.html Tue May 17 15:06:42 2011
+++ /doc/userguide/RobotFrameworkUserGuide.html Fri May 20 00:00:22 2011
@@ -9847,14 +9847,16 @@
format. <a class="reference internal" href="#log-file">Log</a>, <a
class="reference internal" href="#report-file">report</a>, and <a
class="reference internal" href="#summary-file">summary</a> files are
generated based on
output files, and output files can also be <a class="reference internal"
href="#post-processing-outputs">combined and otherwise
post-processed</a> after the test execution.</p>
-<p>The command line option <span class="opt">--output (-o)</span>
determines where
-output files are created. Output files are always created when tests
-are executed, and unless outputs are <a class="reference internal"
href="#splitting-outputs">splitted</a>, only one output file
-is created. The default name for the output file is <span
class="path">output.xml</span>.
-If outputs are splitted to several output files, they are named by
-postfixing the name of the first output file with sequence numbers. When
-post-processing outputs, new output files are not created unless
+<p>The command line option <span class="opt">--output (-o)</span>
determines the path where
+the output file is created relative to the <a class="reference internal"
href="#output-directory">output directory</a>. The default
+name for the output file, when tests are run, is <span
class="path">output.xml</span>. If
+<a class="reference internal" href="#splitting-outputs">outputs are
split</a> to several output files, they are named by
+postfixing the name of the first output file with sequence numbers.</p>
+<p>When post-processing outputs, new output files are not created unless
<span class="opt">--output (-o)</span> option is explicitly used.</p>
+<p>Starting from Robot Framework 2.6, it is possible to disable creation of
+the output file also when running tests with special value <span
class="opt">NONE</span>. In this
+case also other output files, except for the <a class="reference internal"
href="#debug-file">debug file</a>, are disabled.</p>
</div>
<div class="section" id="log-file">
<h4><a class="toc-backref" href="#id491">Log file</a></h4>
@@ -14087,7 +14089,7 @@
<div class="footer">
<hr class="footer" />
<p>Generated by <a class="reference external"
href="http://docutils.sourceforge.net/rst.html";>reStructuredText</a>.
Syntax highlighting by <a class="reference external"
href="http://pygments.org/";>Pygments</a>.</p>
-<p>Generated on: 2011-05-17 22:02 UTC.
+<p>Generated on: 2011-05-20 06:57 UTC.
</p>
</div>
=======================================
--- /doc/userguide/src/ExecutingTestCases/OutputFiles.txt Fri Mar 11
03:59:38 2011
+++ /doc/userguide/src/ExecutingTestCases/OutputFiles.txt Fri May 20
00:00:22 2011
@@ -41,15 +41,19 @@
output files, and output files can also be `combined and otherwise
post-processed`__ after the test execution.
-The command line option :opt:`--output (-o)` determines where
-output files are created. Output files are always created when tests
-are executed, and unless outputs are `splitted`__, only one output file
-is created. The default name for the output file is :path:`output.xml`.
-If outputs are splitted to several output files, they are named by
-postfixing the name of the first output file with sequence numbers. When
-post-processing outputs, new output files are not created unless
+The command line option :opt:`--output (-o)` determines the path where
+the output file is created relative to the `output directory`_. The default
+name for the output file, when tests are run, is :path:`output.xml`. If
+`outputs are split`__ to several output files, they are named by
+postfixing the name of the first output file with sequence numbers.
+
+When post-processing outputs, new output files are not created unless
:opt:`--output (-o)` option is explicitly used.
+Starting from Robot Framework 2.6, it is possible to disable creation of
+the output file also when running tests with special value :opt:`NONE`. In
this
+case also other output files, except for the `debug file`_, are disabled.
+
__ `Post-processing outputs`_
__ `Splitting outputs`_
