jpountz commented on a change in pull request #364:
URL: https://github.com/apache/lucene/pull/364#discussion_r723849356



##########
File path: 
lucene/core/src/java/org/apache/lucene/search/comparators/NumericComparator.java
##########
@@ -130,12 +130,45 @@ public NumericLeafComparator(LeafReaderContext context) 
throws IOException {
       }
     }
 
-    /** Retrieves the NumericDocValues for the field in this segment */
+    /**
+     * Retrieves the NumericDocValues for the field in this segment
+     *
+     * <p>If you override this method, you must also override {@link
+     * #getPointValues(LeafReaderContext, String)} This class uses sort 
optimization that
+     * substitutes an iterator over doc_values with one over points, so it 
relies on the assumption

Review comment:
       Minor suggestion to give a higher-level description of how the 
optimization works since users might not be familiar with the implementation 
deltails.
   
   ```suggestion
        * leverages points to filter out non-competitive matches, which relies 
on the assumption
   ```




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org

Reply via email to