svn commit: r1057011 - in /lucene/dev/branches/branch_3x: ./ lucene/ lucene/src/java/org/apache/lucene/search/Scorer.java solr/

[us...@apache.org]

Author: uschindler
Date: Sun Jan  9 19:50:15 2011
New Revision: 1057011

URL: http://svn.apache.org/viewvc?rev=1057011&view=rev
Log:
LUCENE-2839: Scorer#score(Collector,int,int) is intended to be public, document this in javadocs

Modified:
    lucene/dev/branches/branch_3x/   (props changed)
    lucene/dev/branches/branch_3x/lucene/   (props changed)
    lucene/dev/branches/branch_3x/lucene/src/java/org/apache/lucene/search/Scorer.java
    lucene/dev/branches/branch_3x/solr/   (props changed)

Modified: lucene/dev/branches/branch_3x/lucene/src/java/org/apache/lucene/search/Scorer.java
URL: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/lucene/src/java/org/apache/lucene/search/Scorer.java?rev=1057011&r1=1057010&r2=1057011&view=diff
==============================================================================
--- lucene/dev/branches/branch_3x/lucene/src/java/org/apache/lucene/search/Scorer.java (original)
+++ lucene/dev/branches/branch_3x/lucene/src/java/org/apache/lucene/search/Scorer.java Sun Jan  9 19:50:15 2011
@@ -80,6 +80,12 @@ public abstract class Scorer extends Doc
    * Expert: Collects matching documents in a range. Hook for optimization.
    * Note, <code>firstDocID</code> is added to ensure that {@link #nextDoc()}
    * was called before this method.
+   *
+   * <p><b>NOTE:</b> Because of backwards compatibility, this method is still
+   * declared as <b>protected</b>, but it is intended to be <b>public</b>,
+   * because it's called from other classes (like {@link BooleanScorer}).
+   * If you subclass {@code Scorer}, you should declare the overridden method
+   * as public to ease transition to Lucene 4.0, where it will be public.</p>
    * 
    * @param collector
    *          The collector to which all matching documents are passed.