Update documentation for num.clamp.

sdk/lib/core/num.dart

Index: sdk/lib/core/num.dart
diff --git a/sdk/lib/core/num.dart b/sdk/lib/core/num.dart
index 21f23eef18321ab7fc4b59aa397cdbb7ead0b0d6..ae72216b42f4769bae4a729c57b3eee9e5f504b0 100644
--- a/sdk/lib/core/num.dart
+++ b/sdk/lib/core/num.dart
@@ -296,6 +296,9 @@ abstract class num implements Comparable<num> {
    * The comparison is done using [compareTo] and therefore takes `-0.0` into
    * account. This also implies that [double.NAN] is treated as the maximal
    * double value.
+   *
+   * The arguments [lowerLimit] and [upperLimit] must be a valid range where

[Lasse Reichstein Nielsen, 2016/11/29 16:00:50]

be -> form
(Two numbers is not a range)

[floitsch, 2016/12/01 19:00:49]

Done.

+   * `lowerLimit.compareTo(upperLimit) <= 0`.
    */
   num clamp(num lowerLimit, num upperLimit);