Author: jprantan
Date: Wed Mar 25 07:30:21 2009
New Revision: 1544
Modified:
trunk/doc/userguide/src/CreatingTestData/AdvancedFeatures.txt
Log:
Documentation changes for issue 203.
Modified: trunk/doc/userguide/src/CreatingTestData/AdvancedFeatures.txt
==============================================================================
--- trunk/doc/userguide/src/CreatingTestData/AdvancedFeatures.txt
(original)
+++ trunk/doc/userguide/src/CreatingTestData/AdvancedFeatures.txt Wed Mar
25 07:30:21 2009
@@ -63,17 +63,6 @@
library using the `WITH NAME syntax`_, the specified name must be
used also in the full keyword name.
-Starting from Robot Framework 2.0.5 it is possible to use the
keyword :name:`Set
-Library Order` from `BuiltIn library`_ to specify the priority order
between
-the libraries. This order is then used when multiple keywords are found
with the
-same name instead of failing the test execution due conflicting keyword
names.
-If the library order is set, there is no need to use long format for
selecting
-the keyword. This enables using same user keywords with multiple instances
of
-the same library. If every library is used to access one part of the system
-under test, :name:`Set Library Order` keyword is then used to select the
-application to be used.
-
-
Resource files are specified in the full keyword name, similarly as
library names. The name of the resource is derived from the basename
of the resource file without the file extension. For example, the
@@ -83,6 +72,26 @@
cases, either the files or the keywords must be renamed. The full name
of the keyword is case-, space- and underscore-insensitive, similarly
as normal keyword names.
+
+Specifying Library Search Order
+'''''''''''''''''''''''''''''''
+
+Starting from Robot Framework 2.1 it is possible to use the
keyword :name:`Set
+Library Search Order` from `BuiltIn library`_ to specify the priority order
+between test libraries that are in use.
+If multiple keywords with the same name are found, libraries are gone
through
+in the library search order. The first library containing the keyword is
+selected and the keyword from that library is used. If keyword is not
found,
+test execution fails.
+
+There is no need to use the long format LibraryName.Keyword Name notation
when
+library search order is set. This makes it easier to to use multiple
instances
+of the same library as :name:`Set Library Search Order` keyword can be
used to
+switch between the libraries. This enables using same user keywords
instead of
+duplicating those for all the library instances.
+
+Library search order is valid in the suite level meaning it is available
in the
+same suite where it was set.
Timeouts