diff --git a/platform/util-rt/src/com/intellij/util/containers/ContainerUtilRt.java b/platform/util-rt/src/com/intellij/util/containers/ContainerUtilRt.java
index 571b19c177c5..453b3bda47e1 100644
--- a/platform/util-rt/src/com/intellij/util/containers/ContainerUtilRt.java
+++ b/platform/util-rt/src/com/intellij/util/containers/ContainerUtilRt.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2000-2012 JetBrains s.r.o.
+ * Copyright 2000-2013 JetBrains s.r.o.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -233,7 +233,8 @@ public class ContainerUtilRt {
   }
 
   /**
-   * Optimized toArray() as opposed to the {@link java.util.Collections#emptyList()}.
+   * A variant of {@link java.util.Collections#emptyList()},
+   * except that {@link #toArray()} here does not create garbage <code>new Object[0]</code> constantly.
    */
   private static class EmptyList<T> extends AbstractList<T> implements RandomAccess {
     private static final EmptyList INSTANCE = new EmptyList();
diff --git a/platform/util/src/com/intellij/util/text/StringTokenizer.java b/platform/util/src/com/intellij/util/text/StringTokenizer.java
index 59c76ca9da4c..c9ac8e4c8f83 100644
--- a/platform/util/src/com/intellij/util/text/StringTokenizer.java
+++ b/platform/util/src/com/intellij/util/text/StringTokenizer.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2000-2009 JetBrains s.r.o.
+ * Copyright 2000-2013 JetBrains s.r.o.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,7 +19,7 @@ import java.util.Enumeration;
 import java.util.NoSuchElementException;
 
 /**
- * Copy of java.util.StringTokenizer with getCurrentPosition method.
+ * Copy of {@link java.util.StringTokenizer} with added {@link #getCurrentPosition()} and {@link #reset(String)} methods.
  */
 public class StringTokenizer implements Enumeration<String> {
   private int currentPosition;