pkg/unittest: fixed docs

pkg/unittest/lib/unittest.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * A library for writing dart unit tests.
  *
  * ## Installing ##
  *
  * Use [pub][] to install this package. Add the following to your `pubspec.yaml`
@@ skipping 10 matching lines @@
  * See the [Getting Started](http://pub.dartlang.org/doc)
  * guide for more details.
  *
  * ##Concepts##
  *
  *  * __Tests__: Tests are specified via the top-level function [test], they can be
  *    organized together using [group].
  *  * __Checks__: Test expectations can be specified via [expect]
  *  * __Matchers__: [expect] assertions are written declaratively using the
  *    [Matcher] class.
- *  * __Configuration__: The framework can be adapted by calling [configure] with a
- *    [Configuration]. See the other libraries in the `unittest` package for
- *    alternative implementations of [Configuration] including
- *    `compact_vm_config.dart`, `html_config.dart` and
+ *  * __Configuration__: The framework can be adapted by setting
+ *    [unittestConfiguration] with a [Configuration]. See the other libraries

[gram, 2013/05/13 16:30:03]

Remove trailing whitespace.

+ *    in the `unittest` package for alternative implementations of
+ *    [Configuration] including `compact_vm_config.dart`, `html_config.dart` and
  *    `html_enhanced_config.dart`.
  *
  * ##Examples##
  *
  * A trivial test:
  *
  *     import 'package:unittest/unittest.dart';
  *     main() {
  *       test('this is a test', () {
  *         int x = 2 + 3;
@@ skipping 127 matching lines @@
 import 'dart:math' show max;
 import 'matcher.dart';
 export 'matcher.dart';
 
 part 'src/config.dart';
 part 'src/test_case.dart';
 
 Configuration _config;
 
 /**
- * [Configuration] used by the unittest library. Note that if a 
+ * [Configuration] used by the unittest library. Note that if a
  * configuration has not been set, calling this getter will create
  * a default configuration.
  */
 Configuration get unittestConfiguration {
   if (_config == null) {
     _config = new Configuration();
   }
   return _config;
 }
 
@@ skipping 665 matching lines @@
 void enableTest(int testId) => _setTestEnabledState(testId, true);
 
 /** Disable a test by ID. */
 void disableTest(int testId) => _setTestEnabledState(testId, false);
 
 /** Signature for a test function. */
 typedef dynamic TestFunction();
 
 // Stack formatting utility. Strips extraneous content from a stack trace.
 // Stack frame lines are parsed with a regexp, which has been tested
-// in Chrome, Firefox and the VM. If a line fails to be parsed it is 
+// in Chrome, Firefox and the VM. If a line fails to be parsed it is
 // included in the output to be conservative.
 //
 // The output stack consists of everything after the call to TestCase._run.
 // If we see an 'expect' in the frame we will prune everything above that
 // as well.
 final _frameRegExp = new RegExp(
     r'^\s*' // Skip leading spaces.
     r'(?:'  // Group of choices for the prefix.
       r'(?:#\d+\s*)|' // Skip VM's #<frameNumber>.
       r'(?:at )|'     // Skip Firefox's 'at '.
       r'(?:))'        // Other environments have nothing here.
     r'(.+)'           // Extract the function/method.
     r'\s*[@\(]'       // Skip space and @ or (.
     r'('              // This group of choices is for the source file.
       r'(?:.+:\/\/.+\/[^:]*)|' // Handle file:// or http:// URLs.
       r'(?:dart:[^:]*)|'  // Handle dart:<lib>.
       r'(?:package:[^:]*)' // Handle package:<path>
     r'):([:\d]+)[\)]?$'); // Get the line number and optional column number.
 
 String _formatStack(stack) {
   var lines;
   if (stack is StackTrace) {
     lines = stack.toString().split('\n');
   } else if (stack is String) {
     lines = stack.split('\n');
   } else {
     return stack.toString();
   }
- 
-  // Calculate the max width of first column so we can 
+
+  // Calculate the max width of first column so we can
   // pad to align the second columns.
   int padding = lines.fold(0, (n, line) {
     var match = _frameRegExp.firstMatch(line);
     if (match == null) return n;
     return max(n, match[1].length + 1);
   });
 
   // We remove all entries that have a location in unittest.
   // We strip out anything before _nextBatch too.
   var sb = new StringBuffer();
@@ skipping 23 matching lines @@
         }
         sb.write(location);
         sb.write(' ');
         sb.write(position);
         sb.write('\n');
       }
     }
   }
   return sb.toString();
 }