LUCENE-3312: Add Robert's warning back.

git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/branches/lucene3312@1379945 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/lucene/core/src/java/org/apache/lucene/document/DocumentStoredFieldVisitor.java b/lucene/core/src/java/org/apache/lucene/document/DocumentStoredFieldVisitor.java
index 111fd25..5f566c5 100644
--- a/lucene/core/src/java/org/apache/lucene/document/DocumentStoredFieldVisitor.java
+++ b/lucene/core/src/java/org/apache/lucene/document/DocumentStoredFieldVisitor.java
@@ -99,7 +99,10 @@
 
   /**
    * Retrieve the visited document.
-   * @return StoredDocument populated with stored fields.
+   * @return {@link StoredDocument} populated with stored fields. Note that only
+   *         the stored information in the field instances is valid,
+   *         data such as indexing options, term vector options,
+   *         etc is not set.
    */
   public StoredDocument getDocument() {
     return doc;