Revision: 3863
Author: janne.t.harkonen
Date: Mon Aug 23 03:22:46 2010
Log: regen
http://code.google.com/p/robotframework/source/detail?r=3863
Modified:
/trunk/doc/userguide/RobotFrameworkUserGuide.html
=======================================
--- /trunk/doc/userguide/RobotFrameworkUserGuide.html Mon Jul 12 05:43:57
2010
+++ /trunk/doc/userguide/RobotFrameworkUserGuide.html Mon Aug 23 03:22:46
2010
@@ -1278,7 +1278,7 @@
<p>Test data in HTML files can be edited with whichever editor you
prefer, but a graphic editor, where you can actually see the tables,
is recommended. There is also a tool called <a class="reference internal"
href="#test-data-editing-tool-ride">RIDE</a>
-available that is actually designed for editing the test data.</p>
+available that is designed for editing the test data.</p>
</div>
<div class="section" id="encoding-and-entity-references">
<h5>Encoding and entity references</h5>
@@ -1620,9 +1620,8 @@
</div>
<div class="section" id="syntax-errors-in-rest-source-files">
<h5>Syntax errors in reST source files</h5>
-<p>If you create test data or other portions of a reST file that is not
-syntactically correct (a malformed table for example), the
-reST-to-HTML conversion will not take place and no test cases will be
+<p>If reST file is not syntactically correct (a malformed table for
example),
+the reST-to-HTML conversion will not take place and no test cases will be
read from that file. When this occurs, Robot Framework will show the
docutils error message in it's console output showing the filename,
line number, source context, and type of error.</p>
@@ -1693,7 +1692,7 @@
<p>When Robot Framework parses the test data, it ignores:</p>
<ul class="simple">
<li>All tables that do not start with a recognized table name in the first
cell</li>
-<li>Everything else on the first row apart from the first cell</li>
+<li>Everything else on the first row of a table apart from the first
cell</li>
<li>Data outside tables in HTML/reST and data before the first table in
TSV</li>
<li>All empty rows, which means these kinds of rows can be used to make
the tables more readable</li>
@@ -1757,20 +1756,17 @@
</div>
<div class="section" id="dividing-test-data-to-several-rows">
<h4><a class="toc-backref" href="#id307">Dividing test data to several
rows</a></h4>
-<p>If a keyword requires more arguments than there are columns available,
-it is not necessary to add more columns. Instead, it is possible to
-simply have three dots (<span class="code">...</span>) below the original
keyword name
-and continue arguments there. Arguments presented like this are parsed
-as if they were all in one row.</p>
-<p>The same approach works also with settings and variables taking
-several values. In these cases, the three dots are, of course, placed
-under the setting or variable name.</p>
+<p>If there is more data than readily fits a row, it possible to use
ellipsis
+(<span class="code">...</span>) to continue the previous line. In test
case and user keyword tables,
+the ellipsis must be preceded by at least one empty cell. In settings and
+variable tables, it can be placed directly under the setting or variable
name.</p>
+<p>In all tables, all empty cells before the ellipsis are ignored.</p>
<p>Additionally, values of settings that take only one value (mainly
documentations) can be split to several columns. These values
will be then catenated together with spaces when the test data is
parsed.</p>
-<p>All these syntaxes are illustrated in the following examples. The
-first three tables show tables where test data has not been split, and
+<p>All these syntaxes are illustrated in the following examples. In the
+first three tables test data has not been split, and
the following three illustrate how fewer columns are needed after
splitting the data to several rows.</p>
<table border="1" class="example docutils">
@@ -2028,10 +2024,10 @@
<td>5</td>
</tr>
<tr><td></td>
+<td>...</td>
<td>...</td>
<td>6</td>
<td> </td>
-<td> </td>
</tr>
</tbody>
</table>
@@ -2039,9 +2035,8 @@
<h5>Splitting test data in reST tables</h5>
<p>In the plain text markup for reST tables, there are two types of table
syntax that can be used to create test data. When using the <cite>Simple
-Tables</cite> syntax for test data tables that have data into several rows,
-a <span class="code">\</span> or <span class="code">..</span> is required
in the first cell of a
-continued row in addition to the <span class="code">...</span> required by
Robot Framework.</p>
+Tables</cite> syntax, a <span class="code">\</span> or <span
class="code">..</span> is required in the first cell
+of a continued row in addition to the <span class="code">...</span>
required by Robot Framework.</p>
<p>Here is an example using reST <cite>Simple Table</cite> format:</p>
<pre class="literal-block">
=========== ================ ============== ========== ==========
@@ -13304,7 +13299,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: 2010-07-12 12:43 UTC.
+<p>Generated on: 2010-08-23 10:21 UTC.
</p>
</div>
