svn commit: r1389535 - in /lucene/dev/branches/branch_4x: ./ lucene/ lucene/MIGRATE.txt

[mi...@apache.org]

Author: mikemccand
Date: Mon Sep 24 19:44:01 2012
New Revision: 1389535

URL: http://svn.apache.org/viewvc?rev=1389535&view=rev
Log:
LUCENE-2308: add MIGRATE.txt entry about Document.setBoost

Modified:
    lucene/dev/branches/branch_4x/   (props changed)
    lucene/dev/branches/branch_4x/lucene/   (props changed)
    lucene/dev/branches/branch_4x/lucene/MIGRATE.txt   (contents, props changed)

Modified: lucene/dev/branches/branch_4x/lucene/MIGRATE.txt
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_4x/lucene/MIGRATE.txt?rev=1389535&r1=1389534&r2=1389535&view=diff
==============================================================================
--- lucene/dev/branches/branch_4x/lucene/MIGRATE.txt (original)
+++ lucene/dev/branches/branch_4x/lucene/MIGRATE.txt Mon Sep 24 19:44:01 2012
@@ -543,6 +543,14 @@ you can now do this:
 
     new StoredField("field", bytes)
 
+If you previously used Document.setBoost, you must now pre-multiply
+the document boost into each Field.setBoost.  If you have a
+multi-valued field, you should do this only for the first Field
+instance (ie, subsequent Field instance sharing the same field name
+should only include their per-field boost and not the document level
+boost) as the boost for multi-valued field instances are multiplied
+together by Lucene.
+
 ## Other changes
 
 * LUCENE-2674: