commit f93f58ead1dd618160edf44d1c1cc98e31724e1c
author Cédric Beust <cedric@color.com> Mon Oct 10 06:36:41 2011 -0700
committer Cédric Beust <cedric@color.com> Mon Oct 10 06:36:41 2011 -0700
tree c44b9dda43b513568fe14565be24fb7180a6899c
parent 8849b3406ef2184ceb6002768a2d087d7a8de8d5

Updated doc about preserve-order="true" by default.

doc/documentation-main.html

diff --git a/doc/documentation-main.html b/doc/documentation-main.html
index da3d7b8..e646c4f 100644
--- a/doc/documentation-main.html
+++ b/doc/documentation-main.html
@@ -130,7 +130,6 @@
 
 &nbsp;&nbsp;&nbsp;&nbsp;<a class="summary" href="#invokedmethodlistener">5.20 - Invoked method listeners</a></br>
 
-&nbsp;&nbsp;&nbsp;&nbsp;<a class="summary" href="#preserve-order">5.21 - Specifying the ordering of classes</a></br>
 &nbsp;&nbsp;&nbsp;&nbsp;<a class="summary" href="#ihookable">5.22 - Overriding test methods</a></br>
 
 
@@ -650,11 +649,14 @@
 <p>You can also define new groups inside <tt>testng.xml</tt> and specify additional details in attributes, such as whether to run the tests in parallel, how many threads to use, whether you are running JUnit tests, etc...&nbsp;
 <p>
 
-By default, TestNG will run the tests found in your <tt>testng.xml</tt> file in a random order. If you want the classes and methods listed in this file to be run in the exact same order you specified them, use the <tt>preserve-order</tt> attribute:
+By default, TestNG will run your tests in the order they are found in the XML
+file. If you want the classes and methods listed in this file to be
+run in an unpredictible order, set the <tt>preserve-order</tt>
+attribute to <tt>false</tt>
 
 <h3 class="sourcetitle">testng.xml</h3>
 <pre class="brush: xml">
-&lt;test name="Regression1" preserve-order="true"&gt;
+&lt;test name="Regression1" preserve-order="false"&gt;
   &lt;classes&gt;
 
     &lt;class name="test.Test1"&gt;
@@ -670,8 +672,6 @@
 &lt;/test&gt;
 </pre>
 
-In the example above, the test classes will be run in the order <tt>Test1#m1, Test1#m2</tt> and then all the test methods found in <tt>Test2</tt>.
-
 <p>
 
 Please see the DTD for a complete list of the features, or read on.</p>
@@ -2266,40 +2266,6 @@
 
 
 <!-------------------------------------
-  TEST ORDERING
-  ------------------------------------>
-
-<h4>
-<a name="preserve-order">5.21 - Specifying the ordering of classes</a></h4>
-</h4>
-
-<p>
-
-You can specify the order in which your tests are run in several ways.  The most flexible one is to use a method interceptor, as explained in <a href="#methodinterceptors">this section</a>.  You can also use your XML file to specify that your classes should be run in a certain order.
-
-<p>
-
-By default, the classes specified in your XML file will be run in a non-deterministic order, but if you specify <tt>preserve-order="true"</tt> in the <tt>&lt;test&gt;</tt> tag, then TestNG will run these classes in the same order you listed them:
-
-<h3 class="sourcetitle">testng.xml</h3>
-<pre class="brush: xml; highlight: [4]">
-&lt;!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" &gt;
- 
-&lt;suite name="Suite" &gt;
-  &lt;test name="Test" preserve-order="true"&gt;
-    &lt;classes&gt;
-       &lt;class name="test.tmp.A" /&gt;
-       &lt;class name="test.tmp.B" /&gt;
-    &lt;/classes&gt;
-  &lt;/test&gt;
-&lt;/suite&gt;
-</pre>
-
-Because the attribute <tt>preserve-order</tt> was specifid on your <tt>&lt;test&gt;</tt> tag, TestNG will first run all the test methods on the class <tt>test.tmp.A</tt> first, and then on <tt>test.tmp.B</tt>.
-
-</pre>
-
-<!-------------------------------------
   IHOOKABLE AND ICONFIGURABLE
   ------------------------------------>