Updating the back-compat tests

To modify and test backwards branch since Lucene 3.1-dev (https://issues.apache.org/jira/browse/LUCENE-2193), you need at least subversion v1.5.0. Steps:

  • 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:

  • 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
  • Commit from that dir & plant a new tag
  • Update common-build.xml to point to the new tag
  • Maybe run "ant test-tag" again and confirm everything passes
  • 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
      tags.dir= #enter the path to the folder that holds the lucene_2_4_back_compat_tests checkout folder
      compatibility.tag=lucene_2_4_back_compat_tests


  • 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"/>
  • Remove the build.properties file you created (or comment out each line with #) and run ant clean test to ensure everything is correct.
  • Finally, commit your changes as well as the updated common-build.xml
  • No labels