add some documentation on large index support (#1564870)

git-svn-id: https://svn.code.sf.net/p/jackcess/code/jackcess/trunk@330 f203690c-595d-4dc9-a70b-905162fa7fd2

2 files changed, 15 insertions, 2 deletions

diff --git a/src/java/com/healthmarketscience/jackcess/Database.java b/src/java/com/healthmarketscience/jackcess/Database.java
index ebc7809..189c9cc 100644
--- a/src/java/com/healthmarketscience/jackcess/Database.java
+++ b/src/java/com/healthmarketscience/jackcess/Database.java
@@ -61,6 +61,19 @@ import org.apache.commons.logging.LogFactory;
 
 /**
  * An Access database.
+ * <p>
+ * There is now experimental, optional support for large indexes (disabled by
+ * default).  This optional support can be enabled via a few different means:
+ * <ul>
+ * <li>Setting the system property {@value #USE_BIG_INDEX_PROPERTY} to
+ *     {@code "true"} will enable "large" index support accross the jvm</li>
+ * <li>Calling {@link #setUseBigIndex} with {@code true} on a Database
+ *     instance will enable "large" index support for all tables subsequently
+ *     created from that instance</li>
+ * <li>Calling {@link #getTable(String,boolean)} can selectively
+ *     enable/disable "large" index support on a per-table basis (overriding
+ *     any Database or system property setting)</li>
+ * </ul>
  *
  * @author Tim McCune
  */
diff --git a/src/java/com/healthmarketscience/jackcess/Index.java b/src/java/com/healthmarketscience/jackcess/Index.java
index ec3629d..66f189a 100644
--- a/src/java/com/healthmarketscience/jackcess/Index.java
+++ b/src/java/com/healthmarketscience/jackcess/Index.java
@@ -320,7 +320,7 @@ public abstract class Index implements Comparable<Index> {
     
     if(_readOnly) {
       throw new UnsupportedOperationException(
-          "FIXME cannot write indexes of this type yet");
+          "FIXME cannot write indexes of this type yet, see Database javadoc for info on enabling large index support");
     }
     updateImpl();
   }
@@ -733,7 +733,7 @@ public abstract class Index implements Comparable<Index> {
     if(dataPage.getCompressedEntrySize() > _maxPageEntrySize) {
       if(this instanceof SimpleIndex) {
         throw new UnsupportedOperationException(
-            "FIXME cannot write large index yet");
+            "FIXME cannot write large index yet, see Database javadoc for info on enabling large index support");
       }
       throw new IllegalStateException("data page is too large");
     }