Better documentation on Sets and Maps, and more.

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 eb8f82ce4779381c28a5a63de5b411b4081b9333..bc3c527732c661cba20a1bfc48c0ebe24cc07849 100644
--- a/sdk/lib/core/num.dart
+++ b/sdk/lib/core/num.dart
@@ -22,7 +22,7 @@ abstract class num implements Comparable<num> {
    *
    * Returns the remainder of the euclidean division. The euclidean division of
    * two integers `a` and `b` yields two integers `q` and `r` such that
-   * `a = b*q + r` and `0 <= r < |a|`.
+   * `a == b*q + r` and `0 <= r < a.abs()`.
    *
    * The euclidean division is only defined for integers, but can be easily
    * extended to work with doubles. In that case `r` may have a non-integer
@@ -54,7 +54,7 @@ abstract class num implements Comparable<num> {
   /**
    * Return the remainder of the truncating division of `this` by [other].
    *
-   * The result `r` of this operation satisfies: `this = this ~/ other + r`.
+   * The result `r` of this operation satisfies: `this == this ~/ other + r`.
    * As a consequence the remainder `r` has the same sign as the dividend
    * `this`.
    */
@@ -165,8 +165,8 @@ abstract class num implements Comparable<num> {
   double toDouble();
 
   /**
-   * Converts [this] to a string representation with [fractionDigits] digits
-   * after the decimal point.
+   * Converts [this] as a [double] to a string representation with

[floitsch, 2013/06/06 14:00:53]

"Converts `this` to a [double] and then applies `toStringAsFixed` on the
result." ?


Should we just say that this is equivalent to:
this.toDouble().toStringAsFixed().

See [double.toStringAsFixed].

?

[Lasse Reichstein Nielsen, 2013/06/10 05:48:50]

Done.
That would seem like a recursive definition, since double is a num.
I know that double has its own version, but that means that this description
really only applies to int - which is weird, so I try to write this so it
applies to both int and double.

+   * [fractionDigits] digits after the decimal point.
    *
    * The parameter [fractionDigits] must be an integer satisfying:
    * [:0 <= fractionDigits <= 20:].
@@ -174,8 +174,8 @@ abstract class num implements Comparable<num> {
   String toStringAsFixed(int fractionDigits);
 
   /**
-   * Converts [this] to a string in decimal exponential notation with
-   * [fractionDigits] digits after the decimal point.
+   * Converts [this] as a [double] to a string in decimal exponential notation
+   * with [fractionDigits] digits after the decimal point.
    *
    * If [fractionDigits] is given then it must be an integer satisfying:
    * [:0 <= fractionDigits <= 20:]. Without the parameter the returned string
@@ -184,13 +184,11 @@ abstract class num implements Comparable<num> {
   String toStringAsExponential([int fractionDigits]);
 
   /**
-   * Converts [this] to a string representation with [precision] significant
-   * digits.
+   * Converts [this] as a double to a string representation with [precision]
+   * significant digits.
    *
    * The parameter [precision] must be an integer satisfying:
    * [:1 <= precision <= 21:].
    */
   String toStringAsPrecision(int precision);
-
-
 }