changeset 6374:425d175eca55

Doc clarifications.
author mduigou
date Mon, 05 Nov 2012 16:10:08 -0800
parents 197bf7b0507d
children fdf914a9f584
files src/share/classes/java/util/Sized.java
diffstat 1 files changed, 5 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/src/share/classes/java/util/Sized.java	Mon Nov 05 14:11:21 2012 -0800
+++ b/src/share/classes/java/util/Sized.java	Mon Nov 05 16:10:08 2012 -0800
@@ -26,22 +26,20 @@
 
 /**
  * Implementing this interface allows an object to indicate that its elements
- * may be efficiently counted. Counting is always less than O(n).
- *
- * @author Brian Goetz
+ * may be counted.
  */
 public interface Sized {
-    // @@@ mduigou long longSize perhaps?
     /**
-     * A non-negative integer indicating a count of elements.
+     * A non-negative integer indicating a count of elements for this object.
      *
      * @return non-negative integer indicating a count of elements.
      */
     int size();
 
     /**
-     * Returns {@code true} if the size is zero. May be more efficient than
-     * calculating size.
+     * Returns {@code true} if the size is zero. For some implementations it
+     * may be more much more efficient to determine emptiness or non-emptiness
+     * than to calculate their size.
      *
      * @return  {@code true} if the size is zero otherwise {@code false}.
      */