summaryrefslogtreecommitdiff
path: root/src/library/scala/collection
diff options
context:
space:
mode:
authorstepancheg <stepancheg@epfl.ch>2009-09-26 16:33:54 +0000
committerstepancheg <stepancheg@epfl.ch>2009-09-26 16:33:54 +0000
commitf7ba972de12ea2c0a39fef6db6d4a56b47b647e4 (patch)
tree0afb0cc25d70f543983b14bb086fcb62bbc1e31c /src/library/scala/collection
parent490218b35410873704e1bd97e7126e879204f0d0 (diff)
downloadscala-f7ba972de12ea2c0a39fef6db6d4a56b47b647e4.tar.gz
scala-f7ba972de12ea2c0a39fef6db6d4a56b47b647e4.tar.bz2
scala-f7ba972de12ea2c0a39fef6db6d4a56b47b647e4.zip
add @since annotations
Diffstat (limited to 'src/library/scala/collection')
-rw-r--r--src/library/scala/collection/immutable/BitSet.scala2
-rw-r--r--src/library/scala/collection/immutable/HashMap.scala2
-rw-r--r--src/library/scala/collection/immutable/HashSet.scala2
-rw-r--r--src/library/scala/collection/immutable/ImmutableIterator.scala.disabled2
-rw-r--r--src/library/scala/collection/immutable/IntMap.scala5
-rw-r--r--src/library/scala/collection/immutable/Iterable.scala2
-rw-r--r--src/library/scala/collection/immutable/LinearSequence.scala5
-rw-r--r--src/library/scala/collection/immutable/List.scala4
-rw-r--r--src/library/scala/collection/immutable/ListMap.scala3
-rw-r--r--src/library/scala/collection/immutable/ListSet.scala6
-rw-r--r--src/library/scala/collection/immutable/LongMap.scala5
-rw-r--r--src/library/scala/collection/immutable/Map.scala6
-rw-r--r--src/library/scala/collection/immutable/MapLike.scala1
-rw-r--r--src/library/scala/collection/immutable/MapProxy.scala1
-rw-r--r--src/library/scala/collection/immutable/PagedSeq.scala3
-rw-r--r--src/library/scala/collection/immutable/Queue.scala1
-rw-r--r--src/library/scala/collection/immutable/RedBlack.scala3
-rw-r--r--src/library/scala/collection/immutable/Sequence.scala5
-rw-r--r--src/library/scala/collection/immutable/Set.scala1
-rw-r--r--src/library/scala/collection/immutable/SetProxy.scala2
-rw-r--r--src/library/scala/collection/immutable/SortedMap.scala4
-rw-r--r--src/library/scala/collection/immutable/SortedSet.scala1
-rw-r--r--src/library/scala/collection/immutable/Stack.scala1
-rw-r--r--src/library/scala/collection/immutable/Stream.scala2
-rw-r--r--src/library/scala/collection/immutable/StringLike.scala6
-rw-r--r--src/library/scala/collection/immutable/StringOps.scala3
-rw-r--r--src/library/scala/collection/immutable/Traversable.scala2
-rw-r--r--src/library/scala/collection/immutable/Tree.scala.disabled1
-rw-r--r--src/library/scala/collection/immutable/TreeMap.scala6
-rw-r--r--src/library/scala/collection/immutable/TreeSet.scala3
-rw-r--r--src/library/scala/collection/immutable/Vector.scala5
-rw-r--r--src/library/scala/collection/immutable/WrappedString.scala6
-rw-r--r--src/library/scala/collection/mutable/AddingBuilder.scala2
-rw-r--r--src/library/scala/collection/mutable/ArrayBuffer.scala2
-rw-r--r--src/library/scala/collection/mutable/ArrayBuilder.scala8
-rw-r--r--src/library/scala/collection/mutable/ArrayLike.scala2
-rw-r--r--src/library/scala/collection/mutable/ArrayOps.scala6
-rw-r--r--src/library/scala/collection/mutable/ArrayStack.scala1
-rw-r--r--src/library/scala/collection/mutable/BitSet.scala2
-rw-r--r--src/library/scala/collection/mutable/Buffer.scala1
-rw-r--r--src/library/scala/collection/mutable/BufferLike.scala1
-rw-r--r--src/library/scala/collection/mutable/BufferProxy.scala1
-rw-r--r--src/library/scala/collection/mutable/Builder.scala2
-rw-r--r--src/library/scala/collection/mutable/Cloneable.scala2
-rw-r--r--src/library/scala/collection/mutable/CloneableCollection.scala2
-rw-r--r--src/library/scala/collection/mutable/DefaultEntry.scala3
-rw-r--r--src/library/scala/collection/mutable/DefaultMapModel.scala1
-rw-r--r--src/library/scala/collection/mutable/DoubleLinkedList.scala1
-rw-r--r--src/library/scala/collection/mutable/DoubleLinkedListLike.scala1
-rw-r--r--src/library/scala/collection/mutable/FlatHashTable.scala3
-rw-r--r--src/library/scala/collection/mutable/GenericArray.scala1
-rw-r--r--src/library/scala/collection/mutable/HashEntry.scala3
-rw-r--r--src/library/scala/collection/mutable/HashMap.scala3
-rw-r--r--src/library/scala/collection/mutable/HashSet.scala1
-rw-r--r--src/library/scala/collection/mutable/HashTable.scala1
-rw-r--r--src/library/scala/collection/mutable/History.scala1
-rw-r--r--src/library/scala/collection/mutable/ImmutableMapAdaptor.scala1
-rw-r--r--src/library/scala/collection/mutable/ImmutableSetAdaptor.scala1
-rw-r--r--src/library/scala/collection/mutable/Iterable.scala1
-rw-r--r--src/library/scala/collection/mutable/LazyBuilder.scala2
-rw-r--r--src/library/scala/collection/mutable/LinearSequence.scala2
-rw-r--r--src/library/scala/collection/mutable/LinkedEntry.scala3
-rw-r--r--src/library/scala/collection/mutable/LinkedHashMap.scala4
-rw-r--r--src/library/scala/collection/mutable/LinkedHashSet.scala1
-rw-r--r--src/library/scala/collection/mutable/LinkedList.scala1
-rw-r--r--src/library/scala/collection/mutable/LinkedListLike.scala1
-rw-r--r--src/library/scala/collection/mutable/ListBuffer.scala1
-rw-r--r--src/library/scala/collection/mutable/ListMap.scala3
-rw-r--r--src/library/scala/collection/mutable/Map.scala3
-rw-r--r--src/library/scala/collection/mutable/MapBuilder.scala2
-rw-r--r--src/library/scala/collection/mutable/MapLike.scala2
-rw-r--r--src/library/scala/collection/mutable/MapLikeBase.scala1
-rw-r--r--src/library/scala/collection/mutable/MapProxy.scala1
-rw-r--r--src/library/scala/collection/mutable/MultiMap.scala1
-rw-r--r--src/library/scala/collection/mutable/MutableList.scala1
-rw-r--r--src/library/scala/collection/mutable/ObservableBuffer.scala1
-rw-r--r--src/library/scala/collection/mutable/ObservableMap.scala1
-rw-r--r--src/library/scala/collection/mutable/ObservableSet.scala1
-rw-r--r--src/library/scala/collection/mutable/OpenHashMap.scala4
-rw-r--r--src/library/scala/collection/mutable/PriorityQueue.scala1
-rw-r--r--src/library/scala/collection/mutable/PriorityQueueProxy.scala1
-rw-r--r--src/library/scala/collection/mutable/Publisher.scala1
-rw-r--r--src/library/scala/collection/mutable/Queue.scala1
-rw-r--r--src/library/scala/collection/mutable/QueueProxy.scala1
-rw-r--r--src/library/scala/collection/mutable/ResizableArray.scala1
-rw-r--r--src/library/scala/collection/mutable/RevertibleHistory.scala1
-rw-r--r--src/library/scala/collection/mutable/Sequence.scala3
-rw-r--r--src/library/scala/collection/mutable/Set.scala1
-rw-r--r--src/library/scala/collection/mutable/SetBuilder.scala2
-rw-r--r--src/library/scala/collection/mutable/SetLike.scala1
-rw-r--r--src/library/scala/collection/mutable/SetProxy.scala1
-rw-r--r--src/library/scala/collection/mutable/Stack.scala1
-rw-r--r--src/library/scala/collection/mutable/StackProxy.scala1
-rw-r--r--src/library/scala/collection/mutable/StringBuilder.scala1
-rw-r--r--src/library/scala/collection/mutable/Subscriber.scala1
-rw-r--r--src/library/scala/collection/mutable/SynchronizedBuffer.scala1
-rw-r--r--src/library/scala/collection/mutable/SynchronizedMap.scala1
-rw-r--r--src/library/scala/collection/mutable/SynchronizedPriorityQueue.scala1
-rw-r--r--src/library/scala/collection/mutable/SynchronizedQueue.scala1
-rw-r--r--src/library/scala/collection/mutable/SynchronizedSet.scala1
-rw-r--r--src/library/scala/collection/mutable/SynchronizedStack.scala1
-rw-r--r--src/library/scala/collection/mutable/Traversable.scala1
-rw-r--r--src/library/scala/collection/mutable/Undoable.scala1
-rw-r--r--src/library/scala/collection/mutable/VectorLike.scala2
-rw-r--r--src/library/scala/collection/mutable/VectorView.scala1
-rw-r--r--src/library/scala/collection/mutable/VectorViewLike.scala1
-rw-r--r--src/library/scala/collection/mutable/WeakHashMap.scala3
-rw-r--r--src/library/scala/collection/mutable/WrappedArray.scala1
-rw-r--r--src/library/scala/collection/mutable/WrappedArrayBuilder.scala5
109 files changed, 227 insertions, 4 deletions
diff --git a/src/library/scala/collection/immutable/BitSet.scala b/src/library/scala/collection/immutable/BitSet.scala
index 494562c50f..1d81618a92 100644
--- a/src/library/scala/collection/immutable/BitSet.scala
+++ b/src/library/scala/collection/immutable/BitSet.scala
@@ -16,6 +16,8 @@ import generic._
import BitSetLike.{LogWL, updateArray}
/** A base class for immutable bit sets.
+ *
+ * @since 1
*/
@serializable @SerialVersionUID(1611436763290191562L)
abstract class BitSet extends Set[Int]
diff --git a/src/library/scala/collection/immutable/HashMap.scala b/src/library/scala/collection/immutable/HashMap.scala
index bbffd4e05d..d307241f2a 100644
--- a/src/library/scala/collection/immutable/HashMap.scala
+++ b/src/library/scala/collection/immutable/HashMap.scala
@@ -31,6 +31,7 @@ import annotation.unchecked.uncheckedVariance
*
* @author Martin Odersky
* @version 2.0, 19/01/2007
+ * @since 2.3
*/
@serializable @SerialVersionUID(8886909077084990906L)
class HashMap[A, +B] extends Map[A,B] with MapLike[A, B, HashMap[A, B]] with mutable.HashTable[A] {
@@ -179,6 +180,7 @@ class HashMap[A, +B] extends Map[A,B] with MapLike[A, B, HashMap[A, B]] with mut
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.3
*/
object HashMap extends ImmutableMapFactory[HashMap] {
implicit def builderFactory[A, B]: BuilderFactory[(A, B), HashMap[A, B], Coll] = new MapBuilderFactory[A, B]
diff --git a/src/library/scala/collection/immutable/HashSet.scala b/src/library/scala/collection/immutable/HashSet.scala
index 4ce78f75d4..7d31cadf1c 100644
--- a/src/library/scala/collection/immutable/HashSet.scala
+++ b/src/library/scala/collection/immutable/HashSet.scala
@@ -30,6 +30,7 @@ import generic._
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.3
*/
@serializable @SerialVersionUID(4020728942921483037L)
class HashSet[A] extends Set[A]
@@ -137,6 +138,7 @@ class HashSet[A] extends Set[A]
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.3
*/
object HashSet extends SetFactory[HashSet] {
implicit def builderFactory[A]: BuilderFactory[A, HashSet[A], Coll] = setBuilderFactory[A]
diff --git a/src/library/scala/collection/immutable/ImmutableIterator.scala.disabled b/src/library/scala/collection/immutable/ImmutableIterator.scala.disabled
index db17a0c467..2326bc19f6 100644
--- a/src/library/scala/collection/immutable/ImmutableIterator.scala.disabled
+++ b/src/library/scala/collection/immutable/ImmutableIterator.scala.disabled
@@ -12,6 +12,7 @@
package scala.collection.immutable
/** An object for creating immutable iterators.
+ * @since 2.4
*/
object ImmutableIterator {
case object Empty extends ImmutableIterator[Nothing] {
@@ -60,6 +61,7 @@ object ImmutableIterator {
*
* @author Sean McDirmid
* @version 1.0
+ * @since 2.4
*/
sealed abstract class ImmutableIterator[+A] {
diff --git a/src/library/scala/collection/immutable/IntMap.scala b/src/library/scala/collection/immutable/IntMap.scala
index 5d7d385d8c..0ce61f93b4 100644
--- a/src/library/scala/collection/immutable/IntMap.scala
+++ b/src/library/scala/collection/immutable/IntMap.scala
@@ -50,6 +50,9 @@ private[immutable] object IntMapUtils {
import IntMapUtils._
+/**
+ * @since 2.7
+ */
object IntMap {
def empty[T] : IntMap[T] = IntMap.Nil;
def singleton[T](key : Int, value : T) : IntMap[T] = IntMap.Tip(key, value);
@@ -147,6 +150,8 @@ import IntMap._
* Specialised immutable map structure for integer keys, based on
* <a href="http://citeseer.ist.psu.edu/okasaki98fast.html">Fast Mergeable Integer Maps</a>
* by Okasaki and Gill. Essentially a trie based on binary digits of the the integers.
+ *
+ * @since 2.7
*/
sealed abstract class IntMap[+T] extends Map[Int, T] with MapLike[Int, T, IntMap[T]] {
override def empty: IntMap[T] = IntMap.Nil;
diff --git a/src/library/scala/collection/immutable/Iterable.scala b/src/library/scala/collection/immutable/Iterable.scala
index ac4f7701b5..29615a0555 100644
--- a/src/library/scala/collection/immutable/Iterable.scala
+++ b/src/library/scala/collection/immutable/Iterable.scala
@@ -21,6 +21,7 @@ import mutable.Builder
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait Iterable[+A] extends Traversable[A]
with scala.collection.Iterable[A]
@@ -33,6 +34,7 @@ trait Iterable[+A] extends Traversable[A]
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
object Iterable extends TraversableFactory[Iterable] {
implicit def builderFactory[A]: BuilderFactory[A, Iterable[A], Coll] = new VirtualBuilderFactory[A]
diff --git a/src/library/scala/collection/immutable/LinearSequence.scala b/src/library/scala/collection/immutable/LinearSequence.scala
index 303e24aa5a..acfe7e826e 100644
--- a/src/library/scala/collection/immutable/LinearSequence.scala
+++ b/src/library/scala/collection/immutable/LinearSequence.scala
@@ -17,6 +17,8 @@ import mutable.Builder
/** A subtrait of <code>collection.Sequence</code> which represents sequences
* that cannot be mutated.
+ *
+ * @since 2.8
*/
trait LinearSequence[+A] extends Sequence[A]
with scala.collection.LinearSequence[A]
@@ -25,6 +27,9 @@ trait LinearSequence[+A] extends Sequence[A]
override def companion: GenericCompanion[LinearSequence] = LinearSequence
}
+/**
+ * @since 2.8
+ */
object LinearSequence extends SequenceFactory[LinearSequence] {
implicit def builderFactory[A]: BuilderFactory[A, LinearSequence[A], Coll] = new VirtualBuilderFactory[A]
def newBuilder[A]: Builder[A, LinearSequence[A]] = new mutable.ListBuffer
diff --git a/src/library/scala/collection/immutable/List.scala b/src/library/scala/collection/immutable/List.scala
index 6aedee2f25..cea5753e18 100644
--- a/src/library/scala/collection/immutable/List.scala
+++ b/src/library/scala/collection/immutable/List.scala
@@ -24,6 +24,7 @@ import annotation.tailrec
*
* @author Martin Odersky and others
* @version 2.8
+ * @since 2.8
*/
sealed abstract class List[+A] extends LinearSequence[A]
with Product
@@ -438,6 +439,7 @@ sealed abstract class List[+A] extends LinearSequence[A]
*
* @author Martin Odersky
* @version 1.0, 15/07/2003
+ * @since 2.8
*/
@SerialVersionUID(0 - 8256821097970055419L)
case object Nil extends List[Nothing] {
@@ -457,6 +459,7 @@ case object Nil extends List[Nothing] {
*
* @author Martin Odersky
* @version 1.0, 15/07/2003
+ * @since 2.8
*/
@SerialVersionUID(0L - 8476791151983527571L)
final case class ::[B](private var hd: B, private[scala] var tl: List[B]) extends List[B] {
@@ -493,6 +496,7 @@ final case class ::[B](private var hd: B, private[scala] var tl: List[B]) extend
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
object List extends SequenceFactory[List] {
diff --git a/src/library/scala/collection/immutable/ListMap.scala b/src/library/scala/collection/immutable/ListMap.scala
index 5f95d4679f..3169aaf608 100644
--- a/src/library/scala/collection/immutable/ListMap.scala
+++ b/src/library/scala/collection/immutable/ListMap.scala
@@ -15,6 +15,8 @@ package immutable
import generic._
/** The canonical factory of <a href="ListMap.html">ListMap</a>'s.
+ *
+ * @since 1
*/
object ListMap extends ImmutableMapFactory[ListMap] {
implicit def builderFactory[A, B]: BuilderFactory[(A, B), ListMap[A, B], Coll] =
@@ -30,6 +32,7 @@ object ListMap extends ImmutableMapFactory[ListMap] {
* @author Matthias Zenger
* @author Martin Oderskty
* @version 2.0, 01/01/2007
+ * @since 1
*/
@serializable @SerialVersionUID(301002838095710379L)
class ListMap[A, +B] extends Map[A, B] with MapLike[A, B, ListMap[A, B]] {
diff --git a/src/library/scala/collection/immutable/ListSet.scala b/src/library/scala/collection/immutable/ListSet.scala
index 98eae7d08e..46186b2c77 100644
--- a/src/library/scala/collection/immutable/ListSet.scala
+++ b/src/library/scala/collection/immutable/ListSet.scala
@@ -14,7 +14,10 @@ package immutable
import generic._
-/** The canonical factory of <a href="ListSet.html">ListSet</a>'s */
+/** The canonical factory of <a href="ListSet.html">ListSet</a>'s
+ *
+ * @since 1
+ */
object ListSet extends SetFactory[ListSet] {
implicit def builderFactory[A]: BuilderFactory[A, ListSet[A], Coll] = setBuilderFactory[A]
override def empty[A] = new ListSet[A]
@@ -28,6 +31,7 @@ object ListSet extends SetFactory[ListSet] {
*
* @author Matthias Zenger
* @version 1.0, 09/07/2003
+ * @since 1
*/
@serializable
class ListSet[A] extends Set[A]
diff --git a/src/library/scala/collection/immutable/LongMap.scala b/src/library/scala/collection/immutable/LongMap.scala
index 956142e54c..e527712475 100644
--- a/src/library/scala/collection/immutable/LongMap.scala
+++ b/src/library/scala/collection/immutable/LongMap.scala
@@ -40,6 +40,9 @@ private[immutable] object LongMapUtils{
import LongMapUtils._
+/**
+ * @since 2.7
+ */
object LongMap{
def empty[T] : LongMap[T] = LongMap.Nil;
def singleton[T](key : Long, value : T) : LongMap[T] = LongMap.Tip(key, value);
@@ -134,6 +137,8 @@ import LongMap._;
* Specialised immutable map structure for long keys, based on
* <a href="http://citeseer.ist.psu.edu/okasaki98fast.html">Fast Mergeable Long Maps</a>
* by Okasaki and Gill. Essentially a trie based on binary digits of the the integers.
+ *
+ * @since 2.7
*/
sealed abstract class LongMap[+T] extends Map[Long, T] with MapLike[Long, T, LongMap[T]] {
override def empty: LongMap[T] = LongMap.Nil;
diff --git a/src/library/scala/collection/immutable/Map.scala b/src/library/scala/collection/immutable/Map.scala
index 25d2ac5b80..1f5b35c1c2 100644
--- a/src/library/scala/collection/immutable/Map.scala
+++ b/src/library/scala/collection/immutable/Map.scala
@@ -14,6 +14,9 @@ package immutable
import generic._
+/**
+ * @since 1
+ */
trait Map[A, +B] extends Iterable[(A, B)]
with scala.collection.Map[A, B]
with MapLike[A, B, Map[A, B]] { self =>
@@ -35,6 +38,9 @@ trait Map[A, +B] extends Iterable[(A, B)]
def withDefaultValue[B1 >: B](d: B1): Map[A, B1] = new Map.WithDefault[A, B1](this, x => d)
}
+/**
+ * @since 1
+ */
object Map extends ImmutableMapFactory[Map] {
implicit def builderFactory[A, B]: BuilderFactory[(A, B), Map[A, B], Coll] = new MapBuilderFactory[A, B]
diff --git a/src/library/scala/collection/immutable/MapLike.scala b/src/library/scala/collection/immutable/MapLike.scala
index 2f8be4c4d5..4139beace7 100644
--- a/src/library/scala/collection/immutable/MapLike.scala
+++ b/src/library/scala/collection/immutable/MapLike.scala
@@ -39,6 +39,7 @@ import generic._
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait MapLike[A, +B, +This <: MapLike[A, B, This] with Map[A, B]] extends scala.collection.MapLike[A, B, This] {
self =>
diff --git a/src/library/scala/collection/immutable/MapProxy.scala b/src/library/scala/collection/immutable/MapProxy.scala
index b17a3bf5a0..b998747f58 100644
--- a/src/library/scala/collection/immutable/MapProxy.scala
+++ b/src/library/scala/collection/immutable/MapProxy.scala
@@ -23,6 +23,7 @@ package immutable
*
* @author Matthias Zenger, Martin Odersky
* @version 2.0, 31/12/2006
+ * @since 2.8
*/
trait MapProxy[A, +B] extends Map[A, B] with MapProxyLike[A, B, Map[A, B]]
{
diff --git a/src/library/scala/collection/immutable/PagedSeq.scala b/src/library/scala/collection/immutable/PagedSeq.scala
index 53e7007d8e..bac49c6934 100644
--- a/src/library/scala/collection/immutable/PagedSeq.scala
+++ b/src/library/scala/collection/immutable/PagedSeq.scala
@@ -17,6 +17,8 @@ import scala.util.matching.Regex
/** The PagedSeq object defines a lazy implementations of
* a random access sequence.
+ *
+ * @since 2.7
*/
object PagedSeq {
final val UndeterminedEnd = Math.MAX_INT
@@ -107,6 +109,7 @@ import PagedSeq._
* in ``pages'', i.e. arrays of fixed size.
*
* @author Martin Odersky
+ * @since 2.7
*/
class PagedSeq[T: ClassManifest] protected(
more: (Array[T], Int, Int) => Int,
diff --git a/src/library/scala/collection/immutable/Queue.scala b/src/library/scala/collection/immutable/Queue.scala
index 2854e62ae9..80c7285be8 100644
--- a/src/library/scala/collection/immutable/Queue.scala
+++ b/src/library/scala/collection/immutable/Queue.scala
@@ -24,6 +24,7 @@ object Queue {
*
* @author Erik Stenman
* @version 1.0, 08/07/2003
+ * @since 1
*/
@serializable
@SerialVersionUID(-7622936493364270175L)
diff --git a/src/library/scala/collection/immutable/RedBlack.scala b/src/library/scala/collection/immutable/RedBlack.scala
index 17b7746260..337e2d51dd 100644
--- a/src/library/scala/collection/immutable/RedBlack.scala
+++ b/src/library/scala/collection/immutable/RedBlack.scala
@@ -12,6 +12,9 @@
package scala.collection
package immutable
+/**
+ * @since 2.3
+ */
@serializable @SerialVersionUID(8691885935445612921L)
abstract class RedBlack[A] {
diff --git a/src/library/scala/collection/immutable/Sequence.scala b/src/library/scala/collection/immutable/Sequence.scala
index 35b236ee99..7127b3fc9d 100644
--- a/src/library/scala/collection/immutable/Sequence.scala
+++ b/src/library/scala/collection/immutable/Sequence.scala
@@ -17,6 +17,8 @@ import mutable.Builder
/** A subtrait of collection.Sequence which represents sequences
* that cannot be mutated.
+ *
+ * @since 2.8
*/
trait Sequence[+A] extends Iterable[A]
with scala.collection.Sequence[A]
@@ -25,6 +27,9 @@ trait Sequence[+A] extends Iterable[A]
override def companion: GenericCompanion[Sequence] = Sequence
}
+/**
+ * @since 2.8
+ */
object Sequence extends SequenceFactory[Sequence] {
implicit def builderFactory[A]: BuilderFactory[A, Sequence[A], Coll] = new VirtualBuilderFactory[A]
def newBuilder[A]: Builder[A, Sequence[A]] = new mutable.ListBuffer
diff --git a/src/library/scala/collection/immutable/Set.scala b/src/library/scala/collection/immutable/Set.scala
index 4ea067edb5..58b3950edf 100644
--- a/src/library/scala/collection/immutable/Set.scala
+++ b/src/library/scala/collection/immutable/Set.scala
@@ -30,6 +30,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
trait Set[A] extends Iterable[A]
with scala.collection.Set[A]
diff --git a/src/library/scala/collection/immutable/SetProxy.scala b/src/library/scala/collection/immutable/SetProxy.scala
index 01e6208423..d5d3bee87b 100644
--- a/src/library/scala/collection/immutable/SetProxy.scala
+++ b/src/library/scala/collection/immutable/SetProxy.scala
@@ -20,6 +20,8 @@ package immutable
* It is most useful for assembling customized set abstractions
* dynamically using object composition and forwarding.
* </p>
+ *
+ * @since 2.8
*/
trait SetProxy[A] extends Set[A] with SetProxyLike[A, Set[A]]
{
diff --git a/src/library/scala/collection/immutable/SortedMap.scala b/src/library/scala/collection/immutable/SortedMap.scala
index 29b5e218de..f2fd591417 100644
--- a/src/library/scala/collection/immutable/SortedMap.scala
+++ b/src/library/scala/collection/immutable/SortedMap.scala
@@ -21,6 +21,7 @@ import annotation.unchecked.uncheckedVariance
* @author Sean McDirmid
* @author Martin Odersky
* @version 2.8
+ * @since 2.4
*/
trait SortedMap[A, +B] extends Map[A, B]
with scala.collection.SortedMap[A, B]
@@ -67,6 +68,9 @@ trait SortedMap[A, +B] extends Map[A, B]
((repr: SortedMap[A, B1]) /: iter) (_ + _)
}
+/**
+ * @since 2.4
+ */
object SortedMap extends ImmutableSortedMapFactory[SortedMap] {
implicit def builderFactory[A, B](implicit ord: Ordering[A]): BuilderFactory[(A, B), SortedMap[A, B], Coll] = new SortedMapBuilderFactory[A, B]
def empty[A, B](implicit ord: Ordering[A]): SortedMap[A, B] = TreeMap.empty[A, B]
diff --git a/src/library/scala/collection/immutable/SortedSet.scala b/src/library/scala/collection/immutable/SortedSet.scala
index 7d01de95d3..2d02493b3e 100644
--- a/src/library/scala/collection/immutable/SortedSet.scala
+++ b/src/library/scala/collection/immutable/SortedSet.scala
@@ -20,6 +20,7 @@ import mutable.Builder
* @author Sean McDirmid
* @author Martin Odersky
* @version 2.8
+ * @since 2.4
*/
trait SortedSet[A] extends Set[A] with scala.collection.SortedSet[A] with SortedSetLike[A, SortedSet[A]] {
/** Needs to be overridden in subclasses. */
diff --git a/src/library/scala/collection/immutable/Stack.scala b/src/library/scala/collection/immutable/Stack.scala
index d4df92b4c0..a7b3e8a614 100644
--- a/src/library/scala/collection/immutable/Stack.scala
+++ b/src/library/scala/collection/immutable/Stack.scala
@@ -30,6 +30,7 @@ object Stack {
*
* @author Matthias Zenger
* @version 1.0, 10/07/2003
+ * @since 1
*/
@serializable @SerialVersionUID(1976480595012942526L)
class Stack[+A] protected (protected val elems: List[A]) extends Sequence[A] {
diff --git a/src/library/scala/collection/immutable/Stream.scala b/src/library/scala/collection/immutable/Stream.scala
index e5555bda4f..01530294e0 100644
--- a/src/library/scala/collection/immutable/Stream.scala
+++ b/src/library/scala/collection/immutable/Stream.scala
@@ -36,6 +36,7 @@ import scala.annotation.tailrec
*
* @author Martin Odersky, Matthias Zenger
* @version 1.1 08/08/03
+ * @since 2.8
*/
abstract class Stream[+A] extends LinearSequence[A]
with GenericTraversableTemplate[A, Stream]
@@ -395,6 +396,7 @@ self =>
*
* @author Martin Odersky, Matthias Zenger
* @version 1.1 08/08/03
+ * @since 2.8
*/
object Stream extends SequenceFactory[Stream] {
diff --git a/src/library/scala/collection/immutable/StringLike.scala b/src/library/scala/collection/immutable/StringLike.scala
index 5d1b581594..3d4a0b8fb9 100644
--- a/src/library/scala/collection/immutable/StringLike.scala
+++ b/src/library/scala/collection/immutable/StringLike.scala
@@ -16,6 +16,9 @@ import generic._
import mutable.Builder
import scala.util.matching.Regex
+/**
+ * @since 2.8
+ */
object StringLike {
// just statics for companion class.
@@ -27,6 +30,9 @@ object StringLike {
import StringLike._
+/**
+ * @since 2.8
+ */
trait StringLike[+Repr] extends VectorLike[Char, Repr] with Ordered[String] {
self =>
diff --git a/src/library/scala/collection/immutable/StringOps.scala b/src/library/scala/collection/immutable/StringOps.scala
index 52e4d33f64..6983995df5 100644
--- a/src/library/scala/collection/immutable/StringOps.scala
+++ b/src/library/scala/collection/immutable/StringOps.scala
@@ -12,6 +12,9 @@
package scala.collection
package immutable
+/**
+ * @since 2.8
+ */
class StringOps(override val repr: String) extends StringLike[String] {
override protected[this] def thisCollection: WrappedString = new WrappedString(repr)
diff --git a/src/library/scala/collection/immutable/Traversable.scala b/src/library/scala/collection/immutable/Traversable.scala
index e2c960140c..8309e30302 100644
--- a/src/library/scala/collection/immutable/Traversable.scala
+++ b/src/library/scala/collection/immutable/Traversable.scala
@@ -21,6 +21,7 @@ import mutable.Builder
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait Traversable[+A] extends scala.collection.Traversable[A]
with GenericTraversableTemplate[A, Traversable]
@@ -33,6 +34,7 @@ trait Traversable[+A] extends scala.collection.Traversable[A]
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
object Traversable extends TraversableFactory[Traversable] {
implicit def builderFactory[A]: BuilderFactory[A, Traversable[A], Coll] =
diff --git a/src/library/scala/collection/immutable/Tree.scala.disabled b/src/library/scala/collection/immutable/Tree.scala.disabled
index 538b2ccf9f..18b0ced43d 100644
--- a/src/library/scala/collection/immutable/Tree.scala.disabled
+++ b/src/library/scala/collection/immutable/Tree.scala.disabled
@@ -56,6 +56,7 @@ package scala.collection.immutable
*
* @author Erik Stenman, Michel Schinz
* @version 1.1, 2005-01-20
+ * @since 1
*/
@serializable
diff --git a/src/library/scala/collection/immutable/TreeMap.scala b/src/library/scala/collection/immutable/TreeMap.scala
index 7de19754f0..773f805f36 100644
--- a/src/library/scala/collection/immutable/TreeMap.scala
+++ b/src/library/scala/collection/immutable/TreeMap.scala
@@ -15,7 +15,10 @@ package immutable
import generic._
import mutable.Builder
-/** The canonical factory of <a href="TreeMap.html">TreeMap</a>'s. */
+/** The canonical factory of <a href="TreeMap.html">TreeMap</a>'s.
+ *
+ * @since 1
+ */
object TreeMap extends ImmutableSortedMapFactory[TreeMap] {
def empty[A, B](implicit ord: Ordering[A]) = new TreeMap[A, B]()(ord)
implicit def builderFactory[A, B](implicit ord: Ordering[A]): BuilderFactory[(A, B), TreeMap[A, B], Coll] = new SortedMapBuilderFactory[A, B]
@@ -27,6 +30,7 @@ object TreeMap extends ImmutableSortedMapFactory[TreeMap] {
* @author Erik Stenman
* @author Matthias Zenger
* @version 1.1, 03/05/2004
+ * @since 1
*/
@serializable
class TreeMap[A, +B](override val size: Int, t: RedBlack[A]#Tree[B])(implicit val ordering: Ordering[A])
diff --git a/src/library/scala/collection/immutable/TreeSet.scala b/src/library/scala/collection/immutable/TreeSet.scala
index 395eb679a6..80c12e1c93 100644
--- a/src/library/scala/collection/immutable/TreeSet.scala
+++ b/src/library/scala/collection/immutable/TreeSet.scala
@@ -16,6 +16,8 @@ import generic._
import mutable.{Builder, AddingBuilder}
/** The canonical factory of <a href="TreeSet.html">TreeSet</a>'s.
+ *
+ * @since 1
*/
object TreeSet extends SortedSetFactory[TreeSet]{
@@ -33,6 +35,7 @@ object TreeSet extends SortedSetFactory[TreeSet]{
*
* @author Martin Odersky
* @version 2.0, 02/01/2007
+ * @since 1
*/
@serializable @SerialVersionUID(-234066569443569402L)
class TreeSet[A](override val size: Int, t: RedBlack[A]#Tree[Unit])
diff --git a/src/library/scala/collection/immutable/Vector.scala b/src/library/scala/collection/immutable/Vector.scala
index a496aefa0b..3bc8955194 100644
--- a/src/library/scala/collection/immutable/Vector.scala
+++ b/src/library/scala/collection/immutable/Vector.scala
@@ -17,6 +17,8 @@ import mutable.{Builder, ArrayBuffer}
/** A subtrait of <code>collection.Vector</code> which represents sequences
* that cannot be mutated.
+ *
+ * @since 2.8
*/
trait Vector[+A] extends Sequence[A]
with scala.collection.Vector[A]
@@ -25,6 +27,9 @@ trait Vector[+A] extends Sequence[A]
override def companion: GenericCompanion[Vector] = Vector
}
+/**
+ * @since 2.8
+ */
object Vector extends SequenceFactory[Vector] {
// todo: insert better vector implementation here
@serializable @SerialVersionUID(7129304555082767876L)
diff --git a/src/library/scala/collection/immutable/WrappedString.scala b/src/library/scala/collection/immutable/WrappedString.scala
index 42b2c7292b..a4dcfbe0a9 100644
--- a/src/library/scala/collection/immutable/WrappedString.scala
+++ b/src/library/scala/collection/immutable/WrappedString.scala
@@ -16,6 +16,9 @@ import generic._
import mutable.Builder
import scala.util.matching.Regex
+/**
+ * @since 2.8
+ */
class WrappedString(override val self: String) extends Vector[Char] with StringLike[WrappedString] with Proxy {
override protected[this] def thisCollection: WrappedString = this
@@ -25,6 +28,9 @@ class WrappedString(override val self: String) extends Vector[Char] with StringL
override protected[this] def newBuilder = WrappedString.newBuilder
}
+/**
+ * @since 2.8
+ */
object WrappedString {
def newBuilder: Builder[Char, WrappedString] = new StringBuilder() mapResult (new WrappedString(_))
}
diff --git a/src/library/scala/collection/mutable/AddingBuilder.scala b/src/library/scala/collection/mutable/AddingBuilder.scala
index a2729c9c0f..2496329c3c 100644
--- a/src/library/scala/collection/mutable/AddingBuilder.scala
+++ b/src/library/scala/collection/mutable/AddingBuilder.scala
@@ -17,6 +17,8 @@ import generic._
* which adds an element to the collection.
* Collections are built from their empty element using this + method.
* @param empty The empty element of the collection.
+ *
+ * @since 2.8
*/
class AddingBuilder[A, Coll <: Addable[A, Coll] with scala.collection.Iterable[A] with scala.collection.IterableLike[A, Coll]](empty: Coll)
extends Builder[A, Coll] {
diff --git a/src/library/scala/collection/mutable/ArrayBuffer.scala b/src/library/scala/collection/mutable/ArrayBuffer.scala
index 7555cc7a00..f0a52d9f26 100644
--- a/src/library/scala/collection/mutable/ArrayBuffer.scala
+++ b/src/library/scala/collection/mutable/ArrayBuffer.scala
@@ -22,6 +22,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@serializable @SerialVersionUID(1529165946227428979L)
class ArrayBuffer[A](override protected val initialSize: Int)
@@ -164,6 +165,7 @@ class ArrayBuffer[A](override protected val initialSize: Int)
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
object ArrayBuffer extends SequenceFactory[ArrayBuffer] {
implicit def builderFactory[A]: BuilderFactory[A, ArrayBuffer[A], Coll] =
diff --git a/src/library/scala/collection/mutable/ArrayBuilder.scala b/src/library/scala/collection/mutable/ArrayBuilder.scala
index 55babd00dd..05ad865862 100644
--- a/src/library/scala/collection/mutable/ArrayBuilder.scala
+++ b/src/library/scala/collection/mutable/ArrayBuilder.scala
@@ -15,9 +15,15 @@ package mutable
import generic._
import scala.reflect.ClassManifest
-/** A builder class for arrays */
+/** A builder class for arrays
+ *
+ * @since 2.8
+ */
abstract class ArrayBuilder[T] extends Builder[T, Array[T]]
+/**
+ * @since 2.8
+ */
object ArrayBuilder {
def make[T: ClassManifest](): ArrayBuilder[T] =
diff --git a/src/library/scala/collection/mutable/ArrayLike.scala b/src/library/scala/collection/mutable/ArrayLike.scala
index 072bd9e6b8..fb9d53991c 100644
--- a/src/library/scala/collection/mutable/ArrayLike.scala
+++ b/src/library/scala/collection/mutable/ArrayLike.scala
@@ -15,6 +15,8 @@ import generic._
/** A subtrait of collection.Vector which represents sequences
* that can be mutated.
+ *
+ * @since 2.8
*/
trait ArrayLike[A, +Repr] extends VectorLike[A, Repr] { self =>
diff --git a/src/library/scala/collection/mutable/ArrayOps.scala b/src/library/scala/collection/mutable/ArrayOps.scala
index 7e2af4d14b..52d069ea2d 100644
--- a/src/library/scala/collection/mutable/ArrayOps.scala
+++ b/src/library/scala/collection/mutable/ArrayOps.scala
@@ -14,6 +14,9 @@ package mutable
import scala.reflect.ClassManifest
+/**
+ * @since 2.8
+ */
abstract class ArrayOps[T] extends ArrayLike[T, Array[T]] {
private def rowBuilder[U]: Builder[U, Array[U]] =
@@ -50,6 +53,9 @@ abstract class ArrayOps[T] extends ArrayLike[T, Array[T]] {
}
}
+/**
+ * @since 2.8
+ */
object ArrayOps {
class ofRef[T <: AnyRef](override val repr: Array[T]) extends ArrayOps[T] with ArrayLike[T, Array[T]] {
diff --git a/src/library/scala/collection/mutable/ArrayStack.scala b/src/library/scala/collection/mutable/ArrayStack.scala
index 83be199f08..5e2f5e2b1a 100644
--- a/src/library/scala/collection/mutable/ArrayStack.scala
+++ b/src/library/scala/collection/mutable/ArrayStack.scala
@@ -33,6 +33,7 @@ private object Utils {
* than the standard mutable stack.
*
* @author David MacIver
+ * @since 2.7
*/
@cloneable
class ArrayStack[T] private(private var table : Array[AnyRef],
diff --git a/src/library/scala/collection/mutable/BitSet.scala b/src/library/scala/collection/mutable/BitSet.scala
index 799f28c1ab..cedad70488 100644
--- a/src/library/scala/collection/mutable/BitSet.scala
+++ b/src/library/scala/collection/mutable/BitSet.scala
@@ -16,6 +16,8 @@ import generic._
import BitSetLike.{LogWL, updateArray}
/** A class for mutable bitsets.
+ *
+ * @since 1
*/
@serializable @SerialVersionUID(8483111450368547763L)
class BitSet(protected var elems: Array[Long]) extends Set[Int]
diff --git a/src/library/scala/collection/mutable/Buffer.scala b/src/library/scala/collection/mutable/Buffer.scala
index 453150ee67..a11ef77fef 100644
--- a/src/library/scala/collection/mutable/Buffer.scala
+++ b/src/library/scala/collection/mutable/Buffer.scala
@@ -22,6 +22,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@cloneable
trait Buffer[A] extends Sequence[A]
diff --git a/src/library/scala/collection/mutable/BufferLike.scala b/src/library/scala/collection/mutable/BufferLike.scala
index a2ac8ed354..428b5b7aa9 100644
--- a/src/library/scala/collection/mutable/BufferLike.scala
+++ b/src/library/scala/collection/mutable/BufferLike.scala
@@ -23,6 +23,7 @@ import script._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
@cloneable
trait BufferLike[A, +This <: BufferLike[A, This] with Buffer[A]]
diff --git a/src/library/scala/collection/mutable/BufferProxy.scala b/src/library/scala/collection/mutable/BufferProxy.scala
index 3b60076cb6..68e25f71ea 100644
--- a/src/library/scala/collection/mutable/BufferProxy.scala
+++ b/src/library/scala/collection/mutable/BufferProxy.scala
@@ -22,6 +22,7 @@ import script._
*
* @author Matthias Zenger
* @version 1.0, 16/04/2004
+ * @since 1
*/
trait BufferProxy[A] extends Buffer[A] with Proxy {
diff --git a/src/library/scala/collection/mutable/Builder.scala b/src/library/scala/collection/mutable/Builder.scala
index 6c292380fd..655f1d12ac 100644
--- a/src/library/scala/collection/mutable/Builder.scala
+++ b/src/library/scala/collection/mutable/Builder.scala
@@ -17,6 +17,8 @@ import generic._
* A builder lets one construct a collection incrementally, by adding
* elements to the builder with += and then converting to the required
* collection type with `result`.
+ *
+ * @since 2.8
*/
trait Builder[-Elem, +To] extends Growable[Elem] {
diff --git a/src/library/scala/collection/mutable/Cloneable.scala b/src/library/scala/collection/mutable/Cloneable.scala
index bcd9312ace..553c4ad7d6 100644
--- a/src/library/scala/collection/mutable/Cloneable.scala
+++ b/src/library/scala/collection/mutable/Cloneable.scala
@@ -13,6 +13,8 @@ package scala.collection
package mutable
/** A trait for cloneable collections.
+ *
+ * @since 2.8
*/
@cloneable
trait Cloneable[+A <: AnyRef] {
diff --git a/src/library/scala/collection/mutable/CloneableCollection.scala b/src/library/scala/collection/mutable/CloneableCollection.scala
index 1fe3692530..11fd15d709 100644
--- a/src/library/scala/collection/mutable/CloneableCollection.scala
+++ b/src/library/scala/collection/mutable/CloneableCollection.scala
@@ -14,6 +14,8 @@ package mutable
/** The J2ME version of the library defined this trait with a <code>clone</code>
* method to substitute for the lack of <code>Object.clone</code> there.
+ *
+ * @since 2.6
*/
@deprecated("use Cloneable instead")
trait CloneableCollection {
diff --git a/src/library/scala/collection/mutable/DefaultEntry.scala b/src/library/scala/collection/mutable/DefaultEntry.scala
index 7c6633f1a5..ec17dab027 100644
--- a/src/library/scala/collection/mutable/DefaultEntry.scala
+++ b/src/library/scala/collection/mutable/DefaultEntry.scala
@@ -12,6 +12,9 @@
package scala.collection
package mutable
+/**
+ * @since 2.3
+ */
@serializable
final class DefaultEntry[A, B](val key: A, var value: B)
extends HashEntry[A, DefaultEntry[A, B]]
diff --git a/src/library/scala/collection/mutable/DefaultMapModel.scala b/src/library/scala/collection/mutable/DefaultMapModel.scala
index d5719a4b6a..345540435d 100644
--- a/src/library/scala/collection/mutable/DefaultMapModel.scala
+++ b/src/library/scala/collection/mutable/DefaultMapModel.scala
@@ -18,6 +18,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait DefaultMapModel[A, B] extends Map[A, B] {
diff --git a/src/library/scala/collection/mutable/DoubleLinkedList.scala b/src/library/scala/collection/mutable/DoubleLinkedList.scala
index d17ed638de..3534e4727b 100644
--- a/src/library/scala/collection/mutable/DoubleLinkedList.scala
+++ b/src/library/scala/collection/mutable/DoubleLinkedList.scala
@@ -20,6 +20,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@serializable @SerialVersionUID(419155950203746706L)
class DoubleLinkedList[A](_elem: A, _next: DoubleLinkedList[A]) extends LinearSequence[A]
diff --git a/src/library/scala/collection/mutable/DoubleLinkedListLike.scala b/src/library/scala/collection/mutable/DoubleLinkedListLike.scala
index 637d67396b..2297d40209 100644
--- a/src/library/scala/collection/mutable/DoubleLinkedListLike.scala
+++ b/src/library/scala/collection/mutable/DoubleLinkedListLike.scala
@@ -19,6 +19,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 2.8
*/
trait DoubleLinkedListLike[A, This >: Null <: LinearSequence[A] with DoubleLinkedListLike[A, This]] extends LinkedListLike[A, This] { self =>
diff --git a/src/library/scala/collection/mutable/FlatHashTable.scala b/src/library/scala/collection/mutable/FlatHashTable.scala
index 824d7b4326..c13d32aaba 100644
--- a/src/library/scala/collection/mutable/FlatHashTable.scala
+++ b/src/library/scala/collection/mutable/FlatHashTable.scala
@@ -13,6 +13,9 @@ package mutable
import Predef._
+/**
+ * @since 2.3
+ */
trait FlatHashTable[A] {
/** The load factor for the hash table; must be < 500 (0.5)
diff --git a/src/library/scala/collection/mutable/GenericArray.scala b/src/library/scala/collection/mutable/GenericArray.scala
index ef8ea6a870..106eedc766 100644
--- a/src/library/scala/collection/mutable/GenericArray.scala
+++ b/src/library/scala/collection/mutable/GenericArray.scala
@@ -20,6 +20,7 @@ import generic._
* @author Matthias Zenger, Burak Emir
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
class GenericArray[A](override val length: Int)
extends Vector[A]
diff --git a/src/library/scala/collection/mutable/HashEntry.scala b/src/library/scala/collection/mutable/HashEntry.scala
index a2488da3c7..426798e8f2 100644
--- a/src/library/scala/collection/mutable/HashEntry.scala
+++ b/src/library/scala/collection/mutable/HashEntry.scala
@@ -8,6 +8,9 @@
package scala.collection
package mutable
+/**
+ * @since 2.8
+ */
trait HashEntry [A, E] {
val key: A
var next: E = _
diff --git a/src/library/scala/collection/mutable/HashMap.scala b/src/library/scala/collection/mutable/HashMap.scala
index 5638e13af8..bef02ebad4 100644
--- a/src/library/scala/collection/mutable/HashMap.scala
+++ b/src/library/scala/collection/mutable/HashMap.scala
@@ -14,6 +14,9 @@ package mutable
import generic._
+/**
+ * @since 1
+ */
@serializable @SerialVersionUID(-8682987922734091219L)
class HashMap[A, B] extends Map[A, B]
with MapLike[A, B, HashMap[A, B]]
diff --git a/src/library/scala/collection/mutable/HashSet.scala b/src/library/scala/collection/mutable/HashSet.scala
index 3f20d0f6cb..536fd638b5 100644
--- a/src/library/scala/collection/mutable/HashSet.scala
+++ b/src/library/scala/collection/mutable/HashSet.scala
@@ -19,6 +19,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.0, 31/12/2006
+ * @since 1
*/
@serializable
class HashSet[A] extends Set[A]
diff --git a/src/library/scala/collection/mutable/HashTable.scala b/src/library/scala/collection/mutable/HashTable.scala
index d8cc3bd828..6726a3dbbc 100644
--- a/src/library/scala/collection/mutable/HashTable.scala
+++ b/src/library/scala/collection/mutable/HashTable.scala
@@ -28,6 +28,7 @@ package mutable
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.0, 31/12/2006
+ * @since 1
*/
trait HashTable[A] {
diff --git a/src/library/scala/collection/mutable/History.scala b/src/library/scala/collection/mutable/History.scala
index 3fa6f7b37f..dcc6539630 100644
--- a/src/library/scala/collection/mutable/History.scala
+++ b/src/library/scala/collection/mutable/History.scala
@@ -20,6 +20,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
@serializable
@SerialVersionUID(5219213543849892588L)
diff --git a/src/library/scala/collection/mutable/ImmutableMapAdaptor.scala b/src/library/scala/collection/mutable/ImmutableMapAdaptor.scala
index 3856a4a6e9..263c4caddf 100644
--- a/src/library/scala/collection/mutable/ImmutableMapAdaptor.scala
+++ b/src/library/scala/collection/mutable/ImmutableMapAdaptor.scala
@@ -22,6 +22,7 @@ package mutable
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.0, 01/01/2007
+ * @since 1
*/
@serializable
class ImmutableMapAdaptor[A, B](protected var imap: immutable.Map[A, B])
diff --git a/src/library/scala/collection/mutable/ImmutableSetAdaptor.scala b/src/library/scala/collection/mutable/ImmutableSetAdaptor.scala
index e4a452e765..8cf3e2920f 100644
--- a/src/library/scala/collection/mutable/ImmutableSetAdaptor.scala
+++ b/src/library/scala/collection/mutable/ImmutableSetAdaptor.scala
@@ -21,6 +21,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 21/07/2003
+ * @since 1
*/
@serializable
class ImmutableSetAdaptor[A](protected var set: immutable.Set[A]) extends Set[A] {
diff --git a/src/library/scala/collection/mutable/Iterable.scala b/src/library/scala/collection/mutable/Iterable.scala
index c9df8627ca..13685b2376 100644
--- a/src/library/scala/collection/mutable/Iterable.scala
+++ b/src/library/scala/collection/mutable/Iterable.scala
@@ -18,6 +18,7 @@ import generic._
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait Iterable[A] extends Traversable[A]
with scala.collection.Iterable[A]
diff --git a/src/library/scala/collection/mutable/LazyBuilder.scala b/src/library/scala/collection/mutable/LazyBuilder.scala
index 7ddcb4a1f1..20a0b6bb9d 100644
--- a/src/library/scala/collection/mutable/LazyBuilder.scala
+++ b/src/library/scala/collection/mutable/LazyBuilder.scala
@@ -13,6 +13,8 @@ package mutable
/** A builder that constructs its result lazily. Iterators or iterables to
* be added to this builder with `++=` are not evaluated until `result` is called.
+ *
+ * @since 2.8
*/
abstract class LazyBuilder[Elem, +To] extends Builder[Elem, To] {
/** The different segments of elements to be added to the builder, represented as iterators */
diff --git a/src/library/scala/collection/mutable/LinearSequence.scala b/src/library/scala/collection/mutable/LinearSequence.scala
index c11893020b..75da5021c3 100644
--- a/src/library/scala/collection/mutable/LinearSequence.scala
+++ b/src/library/scala/collection/mutable/LinearSequence.scala
@@ -16,6 +16,8 @@ import generic._
/** A subtrait of <code>collection.Sequence</code> which represents sequences
* that cannot be mutated.
+ *
+ * @since 2.8
*/
trait LinearSequence[A] extends Sequence[A]
with scala.collection.LinearSequence[A]
diff --git a/src/library/scala/collection/mutable/LinkedEntry.scala b/src/library/scala/collection/mutable/LinkedEntry.scala
index 6170de627b..049cab32c4 100644
--- a/src/library/scala/collection/mutable/LinkedEntry.scala
+++ b/src/library/scala/collection/mutable/LinkedEntry.scala
@@ -12,6 +12,9 @@
package scala.collection
package mutable
+/**
+ * @since 2.8
+ */
@serializable
final class LinkedEntry[A, B](val key: A, var value: B)
extends HashEntry[A, LinkedEntry[A, B]] {
diff --git a/src/library/scala/collection/mutable/LinkedHashMap.scala b/src/library/scala/collection/mutable/LinkedHashMap.scala
index 193850c405..2649a7b376 100644
--- a/src/library/scala/collection/mutable/LinkedHashMap.scala
+++ b/src/library/scala/collection/mutable/LinkedHashMap.scala
@@ -20,12 +20,16 @@ import Predef._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 2.7
*/
object LinkedHashMap extends MutableMapFactory[LinkedHashMap] {
implicit def builderFactory[A, B]: BuilderFactory[(A, B), LinkedHashMap[A, B], Coll] = new MapBuilderFactory[A, B]
def empty[A, B] = new LinkedHashMap[A, B]
}
+/**
+ * @since 2.7
+ */
@serializable
class LinkedHashMap[A, B] extends Map[A, B]
with MapLike[A, B, LinkedHashMap[A, B]]
diff --git a/src/library/scala/collection/mutable/LinkedHashSet.scala b/src/library/scala/collection/mutable/LinkedHashSet.scala
index 4ec6a80108..af02c455b8 100644
--- a/src/library/scala/collection/mutable/LinkedHashSet.scala
+++ b/src/library/scala/collection/mutable/LinkedHashSet.scala
@@ -15,6 +15,7 @@ import generic._
/** Todo: this has O(n) cost for element removal.
* Should be rewritten to be more efficient.
+ * @since 2.2
*/
@serializable
class LinkedHashSet[A] extends Set[A]
diff --git a/src/library/scala/collection/mutable/LinkedList.scala b/src/library/scala/collection/mutable/LinkedList.scala
index 4fc11919a4..cc171c07de 100644
--- a/src/library/scala/collection/mutable/LinkedList.scala
+++ b/src/library/scala/collection/mutable/LinkedList.scala
@@ -20,6 +20,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@serializable
class LinkedList[A](_elem: A, _next: LinkedList[A]) extends LinearSequence[A]
diff --git a/src/library/scala/collection/mutable/LinkedListLike.scala b/src/library/scala/collection/mutable/LinkedListLike.scala
index 5e706b5e62..9ce8284772 100644
--- a/src/library/scala/collection/mutable/LinkedListLike.scala
+++ b/src/library/scala/collection/mutable/LinkedListLike.scala
@@ -22,6 +22,7 @@ import annotation.tailrec
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait LinkedListLike[A, This >: Null <: Sequence[A] with LinkedListLike[A, This]] extends SequenceLike[A, This] { self =>
diff --git a/src/library/scala/collection/mutable/ListBuffer.scala b/src/library/scala/collection/mutable/ListBuffer.scala
index 470936bd82..de7bd72c7d 100644
--- a/src/library/scala/collection/mutable/ListBuffer.scala
+++ b/src/library/scala/collection/mutable/ListBuffer.scala
@@ -20,6 +20,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@serializable @SerialVersionUID(3419063961353022661L)
final class ListBuffer[A]
diff --git a/src/library/scala/collection/mutable/ListMap.scala b/src/library/scala/collection/mutable/ListMap.scala
index c80a265896..329c207a99 100644
--- a/src/library/scala/collection/mutable/ListMap.scala
+++ b/src/library/scala/collection/mutable/ListMap.scala
@@ -14,6 +14,9 @@ package mutable
import generic._
+/**
+ * @since 2.8
+ */
@serializable
class ListMap[A, B] extends Map[A, B] with MapLike[A, B, ListMap[A, B]] {
diff --git a/src/library/scala/collection/mutable/Map.scala b/src/library/scala/collection/mutable/Map.scala
index 87ff3efa73..68656e4648 100644
--- a/src/library/scala/collection/mutable/Map.scala
+++ b/src/library/scala/collection/mutable/Map.scala
@@ -14,6 +14,9 @@ package mutable
import generic._
+/**
+ * @since 1
+ */
trait Map[A, B]
extends Iterable[(A, B)]
with scala.collection.Map[A, B]
diff --git a/src/library/scala/collection/mutable/MapBuilder.scala b/src/library/scala/collection/mutable/MapBuilder.scala
index bcbd50c44e..bb53c1c447 100644
--- a/src/library/scala/collection/mutable/MapBuilder.scala
+++ b/src/library/scala/collection/mutable/MapBuilder.scala
@@ -15,6 +15,8 @@ package mutable
* to add new elements.
* Collections are built from their `empty` element using this + method.
* @param empty The empty element of the collection.
+ *
+ * @since 2.8
*/
class MapBuilder[A, B, Coll <: scala.collection.Map[A, B] with scala.collection.MapLike[A, B, Coll]](empty: Coll)
extends Builder[(A, B), Coll] {
diff --git a/src/library/scala/collection/mutable/MapLike.scala b/src/library/scala/collection/mutable/MapLike.scala
index 3e72d23ba3..9ea83c43c2 100644
--- a/src/library/scala/collection/mutable/MapLike.scala
+++ b/src/library/scala/collection/mutable/MapLike.scala
@@ -41,6 +41,8 @@ import generic._
* It is also good idea to override methods <code>foreach</code> and
* <code>size</code> for efficiency.
* </p>
+ *
+ * @since 2.8
*/
trait MapLike[A, B, +This <: MapLike[A, B, This] with Map[A, B]]
extends MapLikeBase[A, B, This]
diff --git a/src/library/scala/collection/mutable/MapLikeBase.scala b/src/library/scala/collection/mutable/MapLikeBase.scala
index 02b4e5047a..9afbfe2242 100644
--- a/src/library/scala/collection/mutable/MapLikeBase.scala
+++ b/src/library/scala/collection/mutable/MapLikeBase.scala
@@ -29,6 +29,7 @@ package mutable
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait MapLikeBase[A, B, +This <: MapLikeBase[A, B, This] with Map[A, B]]
extends scala.collection.MapLike[A, B, This] with Cloneable[This] {
diff --git a/src/library/scala/collection/mutable/MapProxy.scala b/src/library/scala/collection/mutable/MapProxy.scala
index 2b99ccc0be..b360b95693 100644
--- a/src/library/scala/collection/mutable/MapProxy.scala
+++ b/src/library/scala/collection/mutable/MapProxy.scala
@@ -23,6 +23,7 @@ package mutable
*
* @author Matthias Zenger, Martin Odersky
* @version 2.0, 31/12/2006
+ * @since 1
*/
trait MapProxy[A, B] extends Map[A, B] with MapProxyLike[A, B, Map[A, B]]
diff --git a/src/library/scala/collection/mutable/MultiMap.scala b/src/library/scala/collection/mutable/MultiMap.scala
index 488095770d..b30c82971b 100644
--- a/src/library/scala/collection/mutable/MultiMap.scala
+++ b/src/library/scala/collection/mutable/MultiMap.scala
@@ -20,6 +20,7 @@ package mutable
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
trait MultiMap[A, B] extends Map[A, Set[B]] {
protected def makeSet: Set[B] = new HashSet[B]
diff --git a/src/library/scala/collection/mutable/MutableList.scala b/src/library/scala/collection/mutable/MutableList.scala
index f6b8182d71..dcf163bcb2 100644
--- a/src/library/scala/collection/mutable/MutableList.scala
+++ b/src/library/scala/collection/mutable/MutableList.scala
@@ -24,6 +24,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@serializable @SerialVersionUID(5938451523372603072L)
class MutableList[A] extends LinearSequence[A]
diff --git a/src/library/scala/collection/mutable/ObservableBuffer.scala b/src/library/scala/collection/mutable/ObservableBuffer.scala
index 3f01b62786..200ffbb223 100644
--- a/src/library/scala/collection/mutable/ObservableBuffer.scala
+++ b/src/library/scala/collection/mutable/ObservableBuffer.scala
@@ -21,6 +21,7 @@ import script._
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait ObservableBuffer[A, This <: ObservableBuffer[A, This]]
extends Buffer[A]
diff --git a/src/library/scala/collection/mutable/ObservableMap.scala b/src/library/scala/collection/mutable/ObservableMap.scala
index 5cfb232bf0..4de49c34b2 100644
--- a/src/library/scala/collection/mutable/ObservableMap.scala
+++ b/src/library/scala/collection/mutable/ObservableMap.scala
@@ -23,6 +23,7 @@ import script._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.0, 31/12/2006
+ * @since 1
*/
trait ObservableMap[A, B, This <: ObservableMap[A, B, This]]
extends Map[A, B]
diff --git a/src/library/scala/collection/mutable/ObservableSet.scala b/src/library/scala/collection/mutable/ObservableSet.scala
index 9a688c779f..bb61e6c363 100644
--- a/src/library/scala/collection/mutable/ObservableSet.scala
+++ b/src/library/scala/collection/mutable/ObservableSet.scala
@@ -21,6 +21,7 @@ import script._
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait ObservableSet[A, This <: ObservableSet[A, This]]
extends Set[A]
diff --git a/src/library/scala/collection/mutable/OpenHashMap.scala b/src/library/scala/collection/mutable/OpenHashMap.scala
index b1b5d320d4..044ae59fd8 100644
--- a/src/library/scala/collection/mutable/OpenHashMap.scala
+++ b/src/library/scala/collection/mutable/OpenHashMap.scala
@@ -12,6 +12,9 @@
package scala.collection
package mutable
+/**
+ * @since 2.7
+ */
object OpenHashMap{
def apply[K, V](elems : (K, V)*) = {
val dict = new OpenHashMap[K, V];
@@ -47,6 +50,7 @@ import OpenHashMap.Entry;
* keys should work without significant performance loss.
*
* @author David MacIver
+ * @since 2.7
*/
class OpenHashMap[Key, Value](initialSize : Int) extends scala.collection.mutable.Map[Key, Value]{
def this() = this(8);
diff --git a/src/library/scala/collection/mutable/PriorityQueue.scala b/src/library/scala/collection/mutable/PriorityQueue.scala
index 3936045fa3..b3955acacf 100644
--- a/src/library/scala/collection/mutable/PriorityQueue.scala
+++ b/src/library/scala/collection/mutable/PriorityQueue.scala
@@ -27,6 +27,7 @@ import generic.{ Addable, Growable }
*
* @author Matthias Zenger
* @version 1.0, 03/05/2004
+ * @since 1
*/
@serializable @cloneable
diff --git a/src/library/scala/collection/mutable/PriorityQueueProxy.scala b/src/library/scala/collection/mutable/PriorityQueueProxy.scala
index 42249e7991..d8584e607b 100644
--- a/src/library/scala/collection/mutable/PriorityQueueProxy.scala
+++ b/src/library/scala/collection/mutable/PriorityQueueProxy.scala
@@ -17,6 +17,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 03/05/2004
+ * @since 1
*/
abstract class PriorityQueueProxy[A](implicit ord: Ordering[A]) extends PriorityQueue[A]
with Proxy
diff --git a/src/library/scala/collection/mutable/Publisher.scala b/src/library/scala/collection/mutable/Publisher.scala
index 4918cda3a5..6d1eae7b78 100644
--- a/src/library/scala/collection/mutable/Publisher.scala
+++ b/src/library/scala/collection/mutable/Publisher.scala
@@ -22,6 +22,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait Publisher[A, This <: Publisher[A, This]] {
self: This =>
diff --git a/src/library/scala/collection/mutable/Queue.scala b/src/library/scala/collection/mutable/Queue.scala
index a9b1ec88ea..1c9e98b1f0 100644
--- a/src/library/scala/collection/mutable/Queue.scala
+++ b/src/library/scala/collection/mutable/Queue.scala
@@ -20,6 +20,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@serializable @cloneable
class Queue[A] extends MutableList[A] with Cloneable[Queue[A]] {
diff --git a/src/library/scala/collection/mutable/QueueProxy.scala b/src/library/scala/collection/mutable/QueueProxy.scala
index ecacda9373..53876479ca 100644
--- a/src/library/scala/collection/mutable/QueueProxy.scala
+++ b/src/library/scala/collection/mutable/QueueProxy.scala
@@ -17,6 +17,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.1, 03/05/2004
+ * @since 1
*/
trait QueueProxy[A] extends Queue[A] with Proxy {
diff --git a/src/library/scala/collection/mutable/ResizableArray.scala b/src/library/scala/collection/mutable/ResizableArray.scala
index 7b69d96894..2f45881307 100644
--- a/src/library/scala/collection/mutable/ResizableArray.scala
+++ b/src/library/scala/collection/mutable/ResizableArray.scala
@@ -20,6 +20,7 @@ import generic._
* @author Matthias Zenger, Burak Emir
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
trait ResizableArray[A] extends Vector[A]
with GenericTraversableTemplate[A, ResizableArray]
diff --git a/src/library/scala/collection/mutable/RevertibleHistory.scala b/src/library/scala/collection/mutable/RevertibleHistory.scala
index 77cf2bb27b..08b6b56cac 100644
--- a/src/library/scala/collection/mutable/RevertibleHistory.scala
+++ b/src/library/scala/collection/mutable/RevertibleHistory.scala
@@ -20,6 +20,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 2.8
*/
@serializable
class RevertibleHistory[A <: Undoable, B] extends History[A, B] with Undoable {
diff --git a/src/library/scala/collection/mutable/Sequence.scala b/src/library/scala/collection/mutable/Sequence.scala
index f56c9d4b3d..961c144338 100644
--- a/src/library/scala/collection/mutable/Sequence.scala
+++ b/src/library/scala/collection/mutable/Sequence.scala
@@ -17,6 +17,8 @@ import generic._
/** A subtrait of <code>collection.Sequence</code> which represents sequences
* that can be mutated.
* The class adds an <code>update</code> method to <code>collection.Sequence</code>.
+ *
+ * @since 2.8
*/
trait Sequence[A] extends Iterable[A]
with scala.collection.Sequence[A]
@@ -31,6 +33,7 @@ trait Sequence[A] extends Iterable[A]
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
object Sequence extends SequenceFactory[Sequence] {
implicit def builderFactory[A]: BuilderFactory[A, Sequence[A], Coll] = new VirtualBuilderFactory[A]
diff --git a/src/library/scala/collection/mutable/Set.scala b/src/library/scala/collection/mutable/Set.scala
index 9f24945153..81666512c7 100644
--- a/src/library/scala/collection/mutable/Set.scala
+++ b/src/library/scala/collection/mutable/Set.scala
@@ -25,6 +25,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
trait Set[A] extends Iterable[A]
with scala.collection.Set[A]
diff --git a/src/library/scala/collection/mutable/SetBuilder.scala b/src/library/scala/collection/mutable/SetBuilder.scala
index 0687dbc35d..de88266693 100644
--- a/src/library/scala/collection/mutable/SetBuilder.scala
+++ b/src/library/scala/collection/mutable/SetBuilder.scala
@@ -17,6 +17,8 @@ import generic._
* an efficient + method which adds an element to the collection.
* Collections are built from their empty element using this + method.
* @param empty The empty element of the collection.
+ *
+ * @since 2.8
*/
class SetBuilder[A, Coll <: Addable[A, Coll] with scala.collection.Iterable[A] with scala.collection.IterableLike[A, Coll]](empty: Coll)
extends Builder[A, Coll] {
diff --git a/src/library/scala/collection/mutable/SetLike.scala b/src/library/scala/collection/mutable/SetLike.scala
index fb36212d21..81747cb704 100644
--- a/src/library/scala/collection/mutable/SetLike.scala
+++ b/src/library/scala/collection/mutable/SetLike.scala
@@ -35,6 +35,7 @@ import script._
* <code>size</code> for efficiency.
* </p>
*
+ * @since 2.8
*/
trait SetLike[A, +This <: SetLike[A, This] with Set[A]]
extends scala.collection.SetLike[A, This]
diff --git a/src/library/scala/collection/mutable/SetProxy.scala b/src/library/scala/collection/mutable/SetProxy.scala
index b035d134b8..21778d79bb 100644
--- a/src/library/scala/collection/mutable/SetProxy.scala
+++ b/src/library/scala/collection/mutable/SetProxy.scala
@@ -18,6 +18,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.1, 09/05/2004
+ * @since 1
*/
trait SetProxy[A] extends Set[A] with SetProxyLike[A, Set[A]]
{
diff --git a/src/library/scala/collection/mutable/Stack.scala b/src/library/scala/collection/mutable/Stack.scala
index 65bdae6780..8790a81767 100644
--- a/src/library/scala/collection/mutable/Stack.scala
+++ b/src/library/scala/collection/mutable/Stack.scala
@@ -20,6 +20,7 @@ import generic._
* @author Matthias Zenger
* @author Martin Odersky
* @version 2.8
+ * @since 1
*/
@serializable @cloneable
class Stack[A] private (var elems: List[A]) extends scala.collection.Sequence[A] with Cloneable[Stack[A]] {
diff --git a/src/library/scala/collection/mutable/StackProxy.scala b/src/library/scala/collection/mutable/StackProxy.scala
index 27b248f982..d248ebd961 100644
--- a/src/library/scala/collection/mutable/StackProxy.scala
+++ b/src/library/scala/collection/mutable/StackProxy.scala
@@ -17,6 +17,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 10/05/2004
+ * @since 1
*/
trait StackProxy[A] extends Stack[A] with Proxy {
diff --git a/src/library/scala/collection/mutable/StringBuilder.scala b/src/library/scala/collection/mutable/StringBuilder.scala
index 1fe28e7040..6bebc430a7 100644
--- a/src/library/scala/collection/mutable/StringBuilder.scala
+++ b/src/library/scala/collection/mutable/StringBuilder.scala
@@ -25,6 +25,7 @@ import scala.reflect.Manifest
* @author Stephane Micheloud
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
@serializable
@SerialVersionUID(0 - 8525408645367278351L)
diff --git a/src/library/scala/collection/mutable/Subscriber.scala b/src/library/scala/collection/mutable/Subscriber.scala
index 95b212f2e8..abf92f0840 100644
--- a/src/library/scala/collection/mutable/Subscriber.scala
+++ b/src/library/scala/collection/mutable/Subscriber.scala
@@ -20,6 +20,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait Subscriber[-A, -B] {
def notify(pub: B, event: A): Unit
diff --git a/src/library/scala/collection/mutable/SynchronizedBuffer.scala b/src/library/scala/collection/mutable/SynchronizedBuffer.scala
index 0f5395735f..a089572f98 100644
--- a/src/library/scala/collection/mutable/SynchronizedBuffer.scala
+++ b/src/library/scala/collection/mutable/SynchronizedBuffer.scala
@@ -19,6 +19,7 @@ import script._
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait SynchronizedBuffer[A] extends Buffer[A] {
diff --git a/src/library/scala/collection/mutable/SynchronizedMap.scala b/src/library/scala/collection/mutable/SynchronizedMap.scala
index a831793cb2..d1455a30e5 100644
--- a/src/library/scala/collection/mutable/SynchronizedMap.scala
+++ b/src/library/scala/collection/mutable/SynchronizedMap.scala
@@ -18,6 +18,7 @@ package mutable
*
* @author Matthias Zenger, Martin Odersky
* @version 2.0, 31/12/2006
+ * @since 1
*/
trait SynchronizedMap[A, B] extends Map[A, B] {
diff --git a/src/library/scala/collection/mutable/SynchronizedPriorityQueue.scala b/src/library/scala/collection/mutable/SynchronizedPriorityQueue.scala
index b43067766e..0a1cb0f0ee 100644
--- a/src/library/scala/collection/mutable/SynchronizedPriorityQueue.scala
+++ b/src/library/scala/collection/mutable/SynchronizedPriorityQueue.scala
@@ -18,6 +18,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 03/05/2004
+ * @since 1
*/
class SynchronizedPriorityQueue[A](implicit ord: Ordering[A]) extends PriorityQueue[A] {
diff --git a/src/library/scala/collection/mutable/SynchronizedQueue.scala b/src/library/scala/collection/mutable/SynchronizedQueue.scala
index fc5d6fe20c..379139cb4f 100644
--- a/src/library/scala/collection/mutable/SynchronizedQueue.scala
+++ b/src/library/scala/collection/mutable/SynchronizedQueue.scala
@@ -19,6 +19,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 03/05/2004
+ * @since 1
*/
class SynchronizedQueue[A] extends Queue[A] {
import scala.collection.Traversable
diff --git a/src/library/scala/collection/mutable/SynchronizedSet.scala b/src/library/scala/collection/mutable/SynchronizedSet.scala
index 8870a8b148..a31d0dfb88 100644
--- a/src/library/scala/collection/mutable/SynchronizedSet.scala
+++ b/src/library/scala/collection/mutable/SynchronizedSet.scala
@@ -18,6 +18,7 @@ import script._
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait SynchronizedSet[A] extends Set[A] {
import scala.collection.Traversable
diff --git a/src/library/scala/collection/mutable/SynchronizedStack.scala b/src/library/scala/collection/mutable/SynchronizedStack.scala
index 627c6ea913..069843f822 100644
--- a/src/library/scala/collection/mutable/SynchronizedStack.scala
+++ b/src/library/scala/collection/mutable/SynchronizedStack.scala
@@ -19,6 +19,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 03/05/2004
+ * @since 1
*/
class SynchronizedStack[A] extends Stack[A] {
import scala.collection.Traversable
diff --git a/src/library/scala/collection/mutable/Traversable.scala b/src/library/scala/collection/mutable/Traversable.scala
index f40072ee65..f7889d089e 100644
--- a/src/library/scala/collection/mutable/Traversable.scala
+++ b/src/library/scala/collection/mutable/Traversable.scala
@@ -19,6 +19,7 @@ import generic._
*
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait Traversable[A] extends scala.collection.Traversable[A]
with GenericTraversableTemplate[A, Traversable]
diff --git a/src/library/scala/collection/mutable/Undoable.scala b/src/library/scala/collection/mutable/Undoable.scala
index 1257b0722e..f6cde4dd03 100644
--- a/src/library/scala/collection/mutable/Undoable.scala
+++ b/src/library/scala/collection/mutable/Undoable.scala
@@ -18,6 +18,7 @@ package mutable
*
* @author Matthias Zenger
* @version 1.0, 08/07/2003
+ * @since 1
*/
trait Undoable {
/** Undo the last operation.
diff --git a/src/library/scala/collection/mutable/VectorLike.scala b/src/library/scala/collection/mutable/VectorLike.scala
index a8a505f0e3..3f6a1868cd 100644
--- a/src/library/scala/collection/mutable/VectorLike.scala
+++ b/src/library/scala/collection/mutable/VectorLike.scala
@@ -15,6 +15,8 @@ import generic._
/** A subtrait of scala.collection.Vector which represents sequences
* that can be mutated.
+ *
+ * @since 2.8
*/
trait VectorLike[A, +Repr] extends scala.collection.VectorLike[A, Repr] { self =>
diff --git a/src/library/scala/collection/mutable/VectorView.scala b/src/library/scala/collection/mutable/VectorView.scala
index e1ec320c52..1564511cab 100644
--- a/src/library/scala/collection/mutable/VectorView.scala
+++ b/src/library/scala/collection/mutable/VectorView.scala
@@ -20,6 +20,7 @@ import TraversableView.NoBuilder
* @author Sean McDirmid
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait VectorView[A, +Coll] extends VectorViewLike[A, Coll, VectorView[A, Coll]]
diff --git a/src/library/scala/collection/mutable/VectorViewLike.scala b/src/library/scala/collection/mutable/VectorViewLike.scala
index 35f41b3a6a..dbde90c024 100644
--- a/src/library/scala/collection/mutable/VectorViewLike.scala
+++ b/src/library/scala/collection/mutable/VectorViewLike.scala
@@ -18,6 +18,7 @@ import TraversableView.NoBuilder
* @author Sean McDirmid
* @author Martin Odersky
* @version 2.8
+ * @since 2.8
*/
trait VectorViewLike[A,
+Coll,
diff --git a/src/library/scala/collection/mutable/WeakHashMap.scala b/src/library/scala/collection/mutable/WeakHashMap.scala
index 8c23a99e51..11a12957b6 100644
--- a/src/library/scala/collection/mutable/WeakHashMap.scala
+++ b/src/library/scala/collection/mutable/WeakHashMap.scala
@@ -14,6 +14,9 @@ package mutable
import JavaConversions._
+/**
+ * @since 2.8
+ */
class WeakHashMap[A, B] extends JMapWrapper[A, B](new java.util.WeakHashMap) {
override def empty = new WeakHashMap[A, B]
}
diff --git a/src/library/scala/collection/mutable/WrappedArray.scala b/src/library/scala/collection/mutable/WrappedArray.scala
index 9f5d3d4414..faa1387714 100644
--- a/src/library/scala/collection/mutable/WrappedArray.scala
+++ b/src/library/scala/collection/mutable/WrappedArray.scala
@@ -21,6 +21,7 @@ import scala.collection.generic._
*
* @author Martin Odersky, Stephane Micheloud
* @version 1.0
+ * @since 2.8
*/
abstract class WrappedArray[T] extends Vector[T] with ArrayLike[T, WrappedArray[T]] {
diff --git a/src/library/scala/collection/mutable/WrappedArrayBuilder.scala b/src/library/scala/collection/mutable/WrappedArrayBuilder.scala
index 4544510f84..5b54f43b38 100644
--- a/src/library/scala/collection/mutable/WrappedArrayBuilder.scala
+++ b/src/library/scala/collection/mutable/WrappedArrayBuilder.scala
@@ -15,7 +15,10 @@ package mutable
import generic._
import scala.reflect.ClassManifest
-/** A builder class for arrays */
+/** A builder class for arrays
+ *
+ * @since 2.8
+ */
class WrappedArrayBuilder[A](manifest: ClassManifest[A]) extends Builder[A, WrappedArray[A]] {
private var elems: WrappedArray[A] = _