diff --git a/src/java/org/apache/lucene/search/FieldCache.java b/src/java/org/apache/lucene/search/FieldCache.java
index d6a04ddd114..09815b57254 100644
--- a/src/java/org/apache/lucene/search/FieldCache.java
+++ b/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;
diff --git a/src/java/org/apache/lucene/search/SortComparator.java b/src/java/org/apache/lucene/search/SortComparator.java
index ba48ed98db2..f2a8006b71a 100644
--- a/src/java/org/apache/lucene/search/SortComparator.java
+++ b/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 {
diff --git a/src/java/org/apache/lucene/search/SortComparatorSource.java b/src/java/org/apache/lucene/search/SortComparatorSource.java
index c1418b67856..219f87a8a39 100644
--- a/src/java/org/apache/lucene/search/SortComparatorSource.java
+++ b/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 {
diff --git a/src/java/org/apache/lucene/search/SortField.java b/src/java/org/apache/lucene/search/SortField.java
index 5953671b493..10603bf6472 100644
--- a/src/java/org/apache/lucene/search/SortField.java
+++ b/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). */