Revision: 2936
Author: pekka.klarck
Date: Mon Apr 12 06:22:27 2010
Log: note about support for non-ascii chars in arg files (issue 528)
http://code.google.com/p/robotframework/source/detail?r=2936
Modified:
/trunk/doc/userguide/src/ExecutingTestCases/BasicUsage.txt
=======================================
--- /trunk/doc/userguide/src/ExecutingTestCases/BasicUsage.txt Fri Apr 3
11:53:52 2009
+++ /trunk/doc/userguide/src/ExecutingTestCases/BasicUsage.txt Mon Apr 12
06:22:27 2010
@@ -432,7 +432,7 @@
These files can contain both command line options and paths
to the test data, one per line. They are taken into use with
:opt:`--argumentfile` option (short option :opt:`-A`) along with possible
other
-command line options. Argument files can contain any ASCII
+command line options. Argument files can contain any
characters without escaping, but spaces in the beginning and end
of lines are ignored. Additionally, empty lines and lines starting with
a hash mark (#) are ignored::
@@ -443,6 +443,10 @@
# This is a comment
path/to/my/tests
+.. note:: Starting from Robot Framework 2.5 it is possible to have also
non-ASCII
+ characters in argument files. For this to work, the argument
file must
+ be saved using UTF-8 encoding.
+
Another important usage for argument files is specifying input files or
directories in certain order. This can be very useful if the `alphabetical
default execution order`__ is not suitable::
@@ -458,9 +462,8 @@
placed to the original list of arguments to the same place where the
argument file option was. Argument files can be used either alone so
that they contain all the options and paths to the test data, or along
-with other options and paths. Starting from Robot Framework 2.1 it is
-possible to use :opt:`--argumentfile` option multiple times or even
-recursively::
+with other options and paths. It is possible to use :opt:`--argumentfile`
+option multiple times or even recursively::
pybot --argumentfile all_arguments.txt
pybot --name example --argumentfile other_options_and_paths.txt
