diff --git a/src/java/org/apache/lucene/document/Field.java b/src/java/org/apache/lucene/document/Field.java
index 4979876c4ac..6cd10e6b324 100644
--- a/src/java/org/apache/lucene/document/Field.java
+++ b/src/java/org/apache/lucene/document/Field.java
@@ -524,7 +524,6 @@ public final class Field implements Serializable {
   /**
    * True iff terms are stored as term vector together with their offsets 
    * (start and end positon in source text).
-   * @return
    */
   public boolean isStoreOffsetWithTermVector(){ 
     return storeOffsetWithTermVector; 
@@ -532,7 +531,6 @@ public final class Field implements Serializable {
   
   /**
    * True iff terms are stored as term vector together with their token positions.
-   * @return
    */
   public boolean isStorePositionWithTermVector(){ 
     return storePositionWithTermVector; 
diff --git a/src/java/org/apache/lucene/index/IndexReader.java b/src/java/org/apache/lucene/index/IndexReader.java
index 5e3b405cb1d..5db331b3a76 100644
--- a/src/java/org/apache/lucene/index/IndexReader.java
+++ b/src/java/org/apache/lucene/index/IndexReader.java
@@ -34,7 +34,7 @@ import java.util.Set;
  so that any subclass which implements it is searchable.
 
  <p> Concrete subclasses of IndexReader are usually constructed with a call to
- the static method {@link #open}.
+ one of the static <code>open()</code> methods, e.g. {@link #open(String)}.
 
  <p> For efficiency, in this API documents are often referred to via
  <i>document numbers</i>, non-negative integers which each name a unique
@@ -223,7 +223,7 @@ public abstract class IndexReader {
    * @return array of term frequency vectors. May be null if no term vectors have been
    *  stored for the specified document.
    * @throws IOException if index cannot be accessed
-   * @see Field#TermVector
+   * @see org.apache.lucene.document.Field.TermVector
    */
   abstract public TermFreqVector[] getTermFreqVectors(int docNumber)
           throws IOException;
@@ -241,7 +241,7 @@ public abstract class IndexReader {
    * @return term frequency vector May be null if field does not exist in the specified
    * document or term vector was not stored.
    * @throws IOException if index cannot be accessed
-   * @see Field#TermVector
+   * @see org.apache.lucene.document.Field.TermVector
    */
   abstract public TermFreqVector getTermFreqVector(int docNumber, String field)
           throws IOException;