Index: src/java/org/apache/lucene/util/Version.java
===================================================================
--- src/java/org/apache/lucene/util/Version.java	(revision 908660)
+++ src/java/org/apache/lucene/util/Version.java	(working copy)
@@ -50,20 +50,32 @@
   /** Match settings and bugs in Lucene's 3.0 release. */
   LUCENE_30,
 
-  /** Match settings and bugs in Lucene's 3.1 release. */
+  /** Match settings and bugs in Lucene's 3.1 release. 
+   *  <p>
+   *  Use this to get the latest &amp; greatest settings, bug
+   *  fixes, etc, for Lucene.
+   */
   LUCENE_31,
   
   /* Add new constants for later versions **here** to respect order! */
 
-  /** Use this to get the latest &amp; greatest settings, bug
-   *  fixes, etc, for Lucene.
-   *
+  /**
    * <p><b>WARNING</b>: if you use this setting, and then
    * upgrade to a newer release of Lucene, sizable changes
-   * may happen.  If precise back compatibility is important
+   * may happen.  If backwards compatibility is important
    * then you should instead explicitly specify an actual
-   * version.
+   * version. 
+   * <p>
+   * If you use this constant then you  may need to 
+   * <b>re-index all of your documents</b> when upgrading
+   * Lucene, as the way text is indexed may have changed. 
+   * Additionally, you may need to <b>re-test your entire
+   * application</b> to ensure it behaves as expected, as 
+   * some defaults may have changed and may break functionality 
+   * in your application. 
+   * @deprecated Use an actual version instead. 
    */
+  @Deprecated
   LUCENE_CURRENT;
 
   public boolean onOrAfter(Version other) {