Index: src/java/org/apache/lucene/search/spell/SpellChecker.java
===================================================================
--- src/java/org/apache/lucene/search/spell/SpellChecker.java	(revision 499179)
+++ src/java/org/apache/lucene/search/spell/SpellChecker.java	(working copy)
@@ -99,6 +99,14 @@
   }
 
   /**
+   * As the Lucene similarity is used to fetch the most relevant grammed terms
+   * is not the same as the edit distance strategy used to calculate the best
+   * matching spell checked word from the hits Lucene found, one usually have
+   * to retrieve a couple of numSug in order to get the true best match.
+   *
+   * I.e. if numSug == 1, don't count on that the suggestion is the best one.
+   * Thus you should set this value to <b>at least</b> 5 for a good suggestion.
+   *
    * Suggest similar words
    * @param word String the word you want a spell check done on
    * @param numSug int the number of suggest words
@@ -110,6 +118,14 @@
   }
 
   /**
+   * As the Lucene similarity is used to fetch the most relevant grammed terms
+   * is not the same as the edit distance strategy used to calculate the best
+   * matching spell checked word from the hits Lucene found, one usually have
+   * to retrieve a couple of numSug in order to get the true best match.
+   *
+   * I.e. if numSug == 1, don't count on that the suggestion is the best one.
+   * Thus you should set this value to <b>at least</b> 5 for a good suggestion.
+   *
    * Suggest similar words (restricted or not to a field of a user index)
    * @param word String the word you want a spell check done on
    * @param numSug int the number of suggest words