Updated documentation for testing.Benchmark. No review.

git-svn-id: http://lampsvn.epfl.ch/svn-repos/scala/scala/trunk@25353 5e8d7ff9-d8ef-0310-90f0-a4852d11357a

src/library/scala/testing/Benchmark.scala

@@ -22,8 +22,15 @@ import compat.Platform
  *  {{{
  *  > scala sort1 5 
  *  }}}
- *  This will run the benchmark 10 times, and print the execution times to stdout.
+ *  This will run the benchmark 5 times, forcing a garbage collection 
+ *  between runs, and printing the execution times to stdout. 
  *
+ *  It is also possible to add a multiplier, so
+ *  {{{
+ *  > scala sort1 5 10
+ *  }}}
+ *  will run the entire benchmark 10 times, each time for 5 runs.
+ * 
  *  @author Iulian Dragos, Burak Emir
  */
 trait Benchmark {