diff --git a/solr/src/java/org/apache/solr/highlight/HtmlFormatter.java b/solr/src/java/org/apache/solr/highlight/HtmlFormatter.java
index bbd2911706f..eda5ecf8229 100644
--- a/solr/src/java/org/apache/solr/highlight/HtmlFormatter.java
+++ b/solr/src/java/org/apache/solr/highlight/HtmlFormatter.java
@@ -23,7 +23,7 @@ import org.apache.solr.common.params.HighlightParams;
 import org.apache.solr.common.params.SolrParams;
 
 /**
- * Use the SimpleHTMLFormatter
+ * Use the {@link org.apache.lucene.search.highlight.SimpleHTMLFormatter}
  */
 public class HtmlFormatter extends HighlightingPluginBase implements SolrFormatter 
 {
diff --git a/solr/src/java/org/apache/solr/highlight/RegexFragmenter.java b/solr/src/java/org/apache/solr/highlight/RegexFragmenter.java
index e4caf96c1e2..588762168ab 100644
--- a/solr/src/java/org/apache/solr/highlight/RegexFragmenter.java
+++ b/solr/src/java/org/apache/solr/highlight/RegexFragmenter.java
@@ -32,7 +32,7 @@ import org.apache.solr.common.params.SolrParams;
 import org.apache.solr.common.util.NamedList;
 
 /**
- * Fragmenter that tries to produce snippets that "look" like a regular 
+ * {@link org.apache.lucene.search.highlight.Fragmenter} that tries to produce snippets that "look" like a regular 
  * expression.
  *
  * <code>solrconfig.xml</code> parameters:
diff --git a/solr/src/java/org/apache/solr/highlight/SolrFormatter.java b/solr/src/java/org/apache/solr/highlight/SolrFormatter.java
index b23bd18e3f2..088a88b3348 100644
--- a/solr/src/java/org/apache/solr/highlight/SolrFormatter.java
+++ b/solr/src/java/org/apache/solr/highlight/SolrFormatter.java
@@ -33,11 +33,11 @@ public interface SolrFormatter extends SolrInfoMBean, NamedListInitializedPlugin
   public void init(NamedList args);
 
   /**
-   * Return a formatter appropriate for this field.
+   * Return a {@link org.apache.lucene.search.highlight.Formatter} appropriate for this field.
    * 
    * @param fieldName The name of the field
    * @param params The params controlling Highlighting
-   * @return An appropriate Formatter.
+   * @return An appropriate {@link org.apache.lucene.search.highlight.Formatter}
    */
   public Formatter getFormatter(String fieldName, SolrParams params );
 }
diff --git a/solr/src/java/org/apache/solr/highlight/SolrFragmenter.java b/solr/src/java/org/apache/solr/highlight/SolrFragmenter.java
index 7819bdf90ea..304fdf5fa15 100644
--- a/solr/src/java/org/apache/solr/highlight/SolrFragmenter.java
+++ b/solr/src/java/org/apache/solr/highlight/SolrFragmenter.java
@@ -33,11 +33,11 @@ public interface SolrFragmenter extends SolrInfoMBean, NamedListInitializedPlugi
   public void init(NamedList args);
 
   /**
-   * Return a fragmenter appropriate for this field. 
+   * Return a {@link org.apache.lucene.search.highlight.Fragmenter} appropriate for this field. 
    * 
    * @param fieldName The name of the field
    * @param params The params controlling Highlighting
-   * @return An appropriate Fragmenter.
+   * @return An appropriate {@link org.apache.lucene.search.highlight.Fragmenter}.
    */
   public Fragmenter getFragmenter(String fieldName, SolrParams params);
 }