[Lucene-java Wiki] Update of "UpdatingBackCompatTests" by UweSchindler

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Lucene-java Wiki" for change notification.

The "UpdatingBackCompatTests" page has been changed by UweSchindler.
The comment on this change is: LUCENE-2193.
http://wiki.apache.org/lucene-java/UpdatingBackCompatTests?action=diff&rev1=4&rev2=5

--------------------------------------------------

- = * This is a stub - this entry still needs to be beefed up =
+ = Updating the back-compat tests =
+ To modify backwards branch since Lucene 3.1-dev (https://issues.apache.org/jira/browse/LUCENE-2193):
  
+  * run "svn up" in backwards folder to get the HEAD revision
+  * modify backwards branch
+  * to now test this modified branch revision, run "ant test-backwards -Dbackwards.rev=HEAD" (HEAD is needed to not downgrade your checkout to common-build.xml's rev, if you forget this you have to run "svn up" again before commit)
+  * commit changes in backwards branch with "svn commit" (be sure to change to backwards/$branchname
+  * copy the revision number from commit message and insert into common-build.xml's property $backwards.rev
+  * (test again and) commit trunk
+ 
+ == In the 2.9 and 3.0 branch you need to use the following steps (these branches are not using revision numbers, but tags): ==
  Method 1:
  
  roughly these are the steps:
@@ -9, +18 @@

   * Make mods to tags/lucene_2_4_.../* so "ant test-tag" passes
  
   * Use "svn switch" to switch that tags checkout from a "tag" to the
-    2_4 back compat branch
+   . 2_4 back compat branch
  
   * Commit from that dir & plant a new tag
  
@@ -20, +29 @@

   * Commit at the top level
  
  Method 2:
+ 
   * Checkout Lucene and make your changes
-  
+ 
   * Checkout the backwards compat branch: lucene/java/branches/lucene_2_4_back_compat_tests to lucene_2_4_back_compat_tests.
  
   * Place a build.properties file in your trunk dir with the following lines:
+   . tag=lucene_2_4_back_compat_tests<<BR>> tags.dir= #enter the path to the folder that holds the lucene_2_4_back_compat_tests checkout folder<<BR>> compatibility.tag=lucene_2_4_back_compat_tests<<BR>>
+ 
-     
-     tag=lucene_2_4_back_compat_tests<<BR>>
-     tags.dir=  #enter the path to the folder that holds the lucene_2_4_back_compat_tests checkout folder<<BR>>
-     compatibility.tag=lucene_2_4_back_compat_tests<<BR>>
-  
   * You can then test using ant test / test-tag
  
   * If everything is ok, commit the lucene_2_4_back_compat_tests checkout, and tag (svn copy …) lucene_2_4_back_compat_tests to the next logical back compat tag in lucene/java/tags ie lucene_2_4_back_compat_tests_20090811
- 
  
   * Now update common-build.xml - change compatability.tag to point to the tag you just made ie <property name="compatibility.tag" value="lucene_2_4_back_compat_tests_20090811"/>