diff --git a/lucene/core/src/java/org/apache/lucene/store/CompoundFileDirectory.java b/lucene/core/src/java/org/apache/lucene/store/CompoundFileDirectory.java
index df89dde150b..6e22475eff5 100644
--- a/lucene/core/src/java/org/apache/lucene/store/CompoundFileDirectory.java
+++ b/lucene/core/src/java/org/apache/lucene/store/CompoundFileDirectory.java
@@ -61,6 +61,13 @@ import java.io.IOException;
  *   <li>FileName --&gt; {@link DataOutput#writeString String}</li>
  *   <li>FileData --&gt; raw file data</li>
  * </ul>
+ * <p>Notes:</p>
+ * <ul>
+ *   <li>FileCount indicates how many files are contained in this compound file. 
+ *       The entry table that follows has that many entries. 
+ *   <li>Each directory entry contains a long pointer to the start of this file's data
+ *       section, the files length, and a String with that file's name.
+ * </ul>
  * 
  * @lucene.experimental
  */
diff --git a/lucene/core/src/java/org/apache/lucene/store/CompoundFileWriter.java b/lucene/core/src/java/org/apache/lucene/store/CompoundFileWriter.java
index ae1244e14b2..7b04d658576 100644
--- a/lucene/core/src/java/org/apache/lucene/store/CompoundFileWriter.java
+++ b/lucene/core/src/java/org/apache/lucene/store/CompoundFileWriter.java
@@ -37,26 +37,7 @@ import org.apache.lucene.util.IOUtils;
 /**
  * Combines multiple files into a single compound file.
  * 
- * The file format data file:<br>
- * <ul>
- * <li>VInt Version</li>
- * <li>{File Data} fileCount entries with the raw data of the corresponding file
- * </li>
- * <ul>
- * File format entry table:<br>
- * <ul>
- * <li>int Version</li>
- * <li>VInt fileCount - number of entries with the following structure:</li>
- * <ul>
- * <li>String fileName</li>
- * <li>long dataOffset</li>
- * <li>long dataLength</li>
- * </ul>
- * </li> </ul> The fileCount integer indicates how many files are contained in
- * this compound file. The entry table that follows has that many entries. Each
- * directory entry contains a long pointer to the start of this file's data
- * section, the files length, and a String with that file's name.
- * 
+ * @see CompoundFileDirectory
  * @lucene.internal
  */
 final class CompoundFileWriter implements Closeable{