diff --git a/lucene/src/java/org/apache/lucene/search/Similarity.java b/lucene/src/java/org/apache/lucene/search/Similarity.java
index 28aa36f..b56ebca 100644
--- a/lucene/src/java/org/apache/lucene/search/Similarity.java
+++ b/lucene/src/java/org/apache/lucene/search/Similarity.java
@@ -79,7 +79,7 @@ public abstract class Similarity {
 
   /** Computes the amount of a sloppy phrase match, based on an edit distance.
    * This value is summed for each sloppy phrase match in a document to form
-   * the frequency that is passed to {@link #tf(float)}.
+   * the frequency to be used in scoring instead of the exact term count.
    *
    * <p>A phrase match with a small edit distance to a document passage more
    * closely matches the document, so implementations of this method usually
diff --git a/lucene/src/java/org/apache/lucene/search/TFIDFSimilarity.java b/lucene/src/java/org/apache/lucene/search/TFIDFSimilarity.java
index fb0252b..daf991b 100644
--- a/lucene/src/java/org/apache/lucene/search/TFIDFSimilarity.java
+++ b/lucene/src/java/org/apache/lucene/search/TFIDFSimilarity.java
@@ -578,9 +578,8 @@ public abstract class TFIDFSimilarity extends Similarity implements Serializable
    * is inaccurate, so is {@link IndexSearcher#maxDoc()}, and in the same direction.
    * In addition, {@link IndexSearcher#maxDoc()} is more efficient to compute
    *   
-   * @param term the term in question
+   * @param stats statistics of the term in question
    * @param searcher the document collection being searched
-   * @param docFreq externally computed docFreq for this term
    * @return an IDFExplain object that includes both an idf score factor 
              and an explanation for the term.
    * @throws IOException
@@ -608,7 +607,7 @@ public abstract class TFIDFSimilarity extends Similarity implements Serializable
    * The default implementation sums the idf factor for
    * each term in the phrase.
    * 
-   * @param terms the terms in the phrase
+   * @param stats statistics of the terms in the phrase
    * @param searcher the document collection being searched
    * @return an IDFExplain object that includes both an idf 
    *         score factor for the phrase and an explanation