Adjusting matcher comments with one-line summaries

pkg/matcher/lib/src/numeric_matchers.dart

 // Copyright (c) 2012, 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.
 
 library matcher.numeric_matchers;
 
 import 'interfaces.dart';
 
 /// Returns a matcher which matches if the match argument is greater
 /// than the given [value].
@@ skipping 93 matching lines @@
   }
 
   Description describeMismatch(item, Description mismatchDescription,
                                Map matchState, bool verbose) {
     mismatchDescription.add('is not ');
     return describe(mismatchDescription);
   }
 }
 
 /// Returns a matcher which matches if the match argument is within [delta]
-/// of some [value]; i.e. if the match argument is greater than
+/// of some [value].
+///
+/// In other words, this matches if the match argument is greater than
 /// than or equal [value]-[delta] and less than or equal to [value]+[delta].
 Matcher closeTo(num value, num delta) => new _IsCloseTo(value, delta);
 
 class _IsCloseTo extends Matcher {
   final num _value, _delta;
 
   const _IsCloseTo(this._value, this._delta);
 
   bool matches(item, Map matchState) {
     if (!_isNumeric(item)) {
@@ skipping 77 matching lines @@
     if (item is !num) {
       return mismatchDescription.
           addDescriptionOf(item).
           add(' not numeric');
     } else {
       return super.describeMismatch(item, mismatchDescription,
           matchState, verbose);
     }
   }
 }