lib/collection: better doc for Iterator

Signed-off-by: Alexis Laferrière <alexis.laf@xymus.net>

diff --git a/lib/standard/collection/abstract_collection.nit b/lib/standard/collection/abstract_collection.nit
index 1b1e71e..2f7e454 100644 (file)
--- a/lib/standard/collection/abstract_collection.nit
+++ b/lib/standard/collection/abstract_collection.nit
@@ -179,8 +179,9 @@ interface Collection[E]
        end
 end
 
        end
 end
 

-# Instances of the Iterator class generates a series of elements, one at a time.
-# They are mainly used with collections.
+# Iterators generate a series of elements, one at a time.
+#
+# They are mainly used with collections and obtained from `Collection::iterator`.

 interface Iterator[E]
        # The current item.
        # Require `is_ok`.
 interface Iterator[E]
        # The current item.
        # Require `is_ok`.