diff options
author | stepancheg <stepancheg@epfl.ch> | 2009-09-26 16:33:54 +0000 |
---|---|---|
committer | stepancheg <stepancheg@epfl.ch> | 2009-09-26 16:33:54 +0000 |
commit | f7ba972de12ea2c0a39fef6db6d4a56b47b647e4 (patch) | |
tree | 0afb0cc25d70f543983b14bb086fcb62bbc1e31c /src | |
parent | 490218b35410873704e1bd97e7126e879204f0d0 (diff) | |
download | scala-f7ba972de12ea2c0a39fef6db6d4a56b47b647e4.tar.gz scala-f7ba972de12ea2c0a39fef6db6d4a56b47b647e4.tar.bz2 scala-f7ba972de12ea2c0a39fef6db6d4a56b47b647e4.zip |
add @since annotations
Diffstat (limited to 'src')
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] = _ |