diff --git a/lucene/src/test-framework/org/apache/lucene/util/LuceneTestCase.java b/lucene/src/test-framework/org/apache/lucene/util/LuceneTestCase.java
index f9df8e5..8dbb878 100644
--- a/lucene/src/test-framework/org/apache/lucene/util/LuceneTestCase.java
+++ b/lucene/src/test-framework/org/apache/lucene/util/LuceneTestCase.java
@@ -157,7 +157,7 @@ public abstract class LuceneTestCase extends Assert {
   public static final String TEST_LINE_DOCS_FILE = System.getProperty("tests.linedocsfile", "europarl.lines.txt.gz");
   /** whether or not to clean threads between test invocations: "false", "perMethod", "perClass" */
   public static final String TEST_CLEAN_THREADS = System.getProperty("tests.cleanthreads", "perClass");
-  /** whether or not to clean threads between test invocations: "false", "perMethod", "perClass" */
+  /** Switch throttling depending on nightly mode. */
   public static final Throttling TEST_THROTTLING = TEST_NIGHTLY ? Throttling.SOMETIMES : Throttling.NEVER;
 
   private static final Pattern codecWithParam = Pattern.compile("(.*)\\(\\s*(\\d+)\\s*\\)");
diff --git a/lucene/src/test-framework/org/apache/lucene/util/_TestUtil.java b/lucene/src/test-framework/org/apache/lucene/util/_TestUtil.java
index b298aad..40b58f2 100644
--- a/lucene/src/test-framework/org/apache/lucene/util/_TestUtil.java
+++ b/lucene/src/test-framework/org/apache/lucene/util/_TestUtil.java
@@ -293,14 +293,16 @@ public class _TestUtil {
   public static String randomRealisticUnicodeString(Random r) {
     return randomRealisticUnicodeString(r, 20);
   }
-  
+
   /** Returns random string of length up to maxLength codepoints , all codepoints within the same unicode block. */
+  // TODO: this doesn't use maxLength at all.
   public static String randomRealisticUnicodeString(Random r, int maxLength) {
     return randomRealisticUnicodeString(r, 0, 20);
   }
 
   /** Returns random string of length between min and max codepoints, all codepoints within the same unicode block. */
   public static String randomRealisticUnicodeString(Random r, int minLength, int maxLength) {
+    // TODO: this doesn't fall between min...max, the end claculateed here can be min + max...
     final int end = minLength + r.nextInt(maxLength);
     final int block = r.nextInt(blockStarts.length);
     StringBuilder sb = new StringBuilder();
@@ -470,6 +472,7 @@ public class _TestUtil {
     synchronized (tempFileLocker) {
       if (counter == 0) {
         int newInt = new Random().nextInt();
+        // TODO: man... magic straight from hell - what's this supposed to do? :)
         counter = ((newInt / 65535) & 0xFFFF) + 0x2710;
         counterBase = counter;
       }