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

Reply via email to