diff --git a/modules/suggest/src/java/org/apache/lucene/search/spell/DirectSpellChecker.java b/modules/suggest/src/java/org/apache/lucene/search/spell/DirectSpellChecker.java
index 88e5ca1358c..2e3402ce0a1 100644
--- a/modules/suggest/src/java/org/apache/lucene/search/spell/DirectSpellChecker.java
+++ b/modules/suggest/src/java/org/apache/lucene/search/spell/DirectSpellChecker.java
@@ -318,7 +318,7 @@ public class DirectSpellChecker {
    * @param term Term you want to spell check on
    * @param numSug the maximum number of suggested words
    * @param ir IndexReader to find terms from
-   * @param morePopular return only suggested words that are as frequent or more frequent than the searched word
+   * @param suggestMode specifies when to return suggested words
    * @param accuracy return only suggested words that match with this similarity
    * @return sorted list of the suggested words according to the comparator
    * @throws IOException
diff --git a/modules/suggest/src/java/org/apache/lucene/search/spell/SpellChecker.java b/modules/suggest/src/java/org/apache/lucene/search/spell/SpellChecker.java
index c52c6948872..60d5c0af3d2 100755
--- a/modules/suggest/src/java/org/apache/lucene/search/spell/SpellChecker.java
+++ b/modules/suggest/src/java/org/apache/lucene/search/spell/SpellChecker.java
@@ -219,7 +219,7 @@ public class SpellChecker implements java.io.Closeable {
   }
 
   /**
-   * The accuracy (minimum score) to be used, unless overridden in {@link #suggestSimilar(String, int, org.apache.lucene.index.IndexReader, String, boolean, float)}, to
+   * The accuracy (minimum score) to be used, unless overridden in {@link #suggestSimilar(String, int, IndexReader, String, SuggestMode, float)}, to
    * decide whether a suggestion is included or not.
    * @return The current accuracy setting
    */
@@ -244,7 +244,7 @@ public class SpellChecker implements java.io.Closeable {
    * @throws AlreadyClosedException if the Spellchecker is already closed
    * @return String[]
    *
-   * @see #suggestSimilar(String, int, org.apache.lucene.index.IndexReader, String, boolean, float) 
+   * @see #suggestSimilar(String, int, IndexReader, String, SuggestMode, float) 
    */
   public String[] suggestSimilar(String word, int numSug) throws IOException {
     return this.suggestSimilar(word, numSug, null, null, SuggestMode.SUGGEST_WHEN_NOT_IN_INDEX);
@@ -268,7 +268,7 @@ public class SpellChecker implements java.io.Closeable {
    * @throws AlreadyClosedException if the Spellchecker is already closed
    * @return String[]
    *
-   * @see #suggestSimilar(String, int, org.apache.lucene.index.IndexReader, String, boolean, float)
+   * @see #suggestSimilar(String, int, IndexReader, String, SuggestMode, float)
    */
   public String[] suggestSimilar(String word, int numSug, float accuracy) throws IOException {
     return this.suggestSimilar(word, numSug, null, null, SuggestMode.SUGGEST_WHEN_NOT_IN_INDEX, accuracy);
diff --git a/modules/suggest/src/java/org/apache/lucene/search/spell/SuggestMode.java b/modules/suggest/src/java/org/apache/lucene/search/spell/SuggestMode.java
index 72b269c0b14..252d61ad80e 100644
--- a/modules/suggest/src/java/org/apache/lucene/search/spell/SuggestMode.java
+++ b/modules/suggest/src/java/org/apache/lucene/search/spell/SuggestMode.java
@@ -36,7 +36,7 @@ public enum SuggestMode {
   /**
    * Always attempt to offer suggestions (however, other parameters may limit
    * suggestions. For example, see
-   * {@link DirectSpellChecker.setMaxQueryFrequency} ).
+   * {@link DirectSpellChecker#setMaxQueryFrequency(float)} ).
    */
   SUGGEST_ALWAYS
 }