LUCENE-1483: add missing deprecations

git-svn-id: https://svn.apache.org/repos/asf/lucene/java/trunk@747019 13f79535-47bb-0310-9956-ffa450edef68

src/java/org/apache/lucene/search/FieldCache.java

@@ -265,6 +265,8 @@ public interface FieldCache {
    * @param comparator Used to convert terms into something to sort by.
    * @return Array of sort objects, one for each document.
    * @throws IOException  If any error occurs.
+   * @deprecated Please implement {@link
+   * FieldComparatorSource} directly, instead.
    */
   public Comparable[] getCustom (IndexReader reader, String field, SortComparator comparator)
   throws IOException;

src/java/org/apache/lucene/search/SortComparator.java

@@ -38,6 +38,7 @@ import java.io.IOException;
  *
  * @version $Id$
  * @since   1.4
+ * @deprecated Please use {@link FieldComparatorSource} instead.
  */
 public abstract class SortComparator
 implements SortComparatorSource {

src/java/org/apache/lucene/search/SortComparatorSource.java

@@ -29,6 +29,7 @@ import java.io.Serializable;
  *
  * @version $Id$
  * @since   1.4
+ * @deprecated Please use {@link FieldComparatorSource} instead.
  */
 public interface SortComparatorSource
 extends Serializable {

src/java/org/apache/lucene/search/SortField.java

@@ -401,7 +401,7 @@ implements Serializable {
   }
 
   /** Returns true if <code>o</code> is equal to this.  If a
-   *  {@link SortComparatorSource} or {@link
+   *  {@link SortComparatorSource} (deprecated) or {@link
    *  FieldCache.Parser} was provided, it must properly
    *  implement equals (unless a singleton is always used). */
   public boolean equals(Object o) {
@@ -419,7 +419,7 @@ implements Serializable {
   }
 
   /** Returns true if <code>o</code> is equal to this.  If a
-   *  {@link SortComparatorSource} or {@link
+   *  {@link SortComparatorSource} (deprecated) or {@link
    *  FieldCache.Parser} was provided, it must properly
    *  implement hashCode (unless a singleton is always
    *  used). */