new doc comment generation, including some new ...

new doc comment generation, including some new style doc comments in
collection classes.

1 files changed, 21 insertions, 19 deletions

diff --git a/src/library/scala/collection/MapLike.scala b/src/library/scala/collection/MapLike.scala
index a1ea657553..a9ea82b2f9 100644
--- a/src/library/scala/collection/MapLike.scala
+++ b/src/library/scala/collection/MapLike.scala
@@ -14,28 +14,30 @@ import generic._
 import mutable.{Builder, StringBuilder, MapBuilder}
 import PartialFunction._
 
-/** <p>
- *    A generic template for maps from keys of type <code>A</code> to values
- *    of type <code>B</code>.<br/>
- *    To implement a concrete map, you need to provide implementations of the
- *    following methods (where <code>This</code> is the type of the map in
+/**
+ *    A generic template for maps from keys of type `A` to values
+ *    of type `B`.
+ *
+ *    To implement a concrete map, 'you' need to provide implementations of the
+ *    following methods (where `This` is the type of the map in
  *    question):
- *  </p>
- *  <pre>
- *    <b>def</b> get(key: A): Option[B]
- *    <b>def</b> iterator: Iterator[(A, B)]
- *    <b>def</b> + [B1 >: B](kv: (A, B1)): This
- *    <b>def</b> -(key: A): This</pre>
- *  <p>
+ *    {{{
+ *       def get(key: A): Option[B]
+ *
+ *       def iterator: Iterator[(A, B)]
+ *
+ *       def + [B1 >: B](kv: (A, B1)): This
+ *
+ *       def -(key: A): This</pre>
+ *    }}}
  *    If you wish that methods <code>like</code>, <code>take</code>, <code>drop</code>,
  *    <code>filter</code> return the same kind of map, you should also override:
- *  </p>
- *  <pre>
- *   <b>def</b> empty: This</pre>
- *  <p>
- *    It is also good idea to override methods <code>foreach</code> and
- *    <code>size</code> for efficiency.
- *  </p>
+ *    {{{
+ *       def empty: This
+ *    }}}
+ *
+ *    It is also good idea to override methods `foreach` and
+ *    `size` for efficiency.
  *
  *  @author  Martin Odersky
  *  @version 2.8