Update documentation on .fromEnvironment. Make bool default be false.

sdk/lib/core/int.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.
 
 part of dart.core;
 
 /**
  * An arbitrarily large integer.
  *
  * **Note:** When compiling to JavaScript, integers are
  * implemented as JavaScript numbers. When compiling to JavaScript,
  * integers are therefore restricted to 53 significant bits because
  * all JavaScript numbers are double-precision floating point
  * values. The behavior of the operators and methods in the [int]
  * class therefore sometimes differs between the Dart VM and Dart code
  * compiled to JavaScript.
  *
  * It is a compile-time error for a class to attempt to extend or implement int.
  */
 abstract class int extends num {
   /**
+   * Returns the integer value of the given environment declaration [name].
+   *
+   * if `name` is not declared, the result is [defaultValue].
+   *
+   * Throws a [FormatException] if the value in the environment is not a valid

[Søren Gjesse, 2013/10/31 08:14:30]

The VM implementation currently throws ArgumentError.

[Lasse Reichstein Nielsen, 2013/10/31 11:52:19]

It also fails on other parts of the parsing. We should fix that.

+   * integer, as accepted by [parse] with no radix.
+   *
+   * Example:
+   *
+   *     const int.fromEnvironment("defaultPort", defaultValue: 80)
+   */
+  external const factory int.fromEnvironment(String name, {int defaultValue});
+
+  /**
    * Bit-wise and operator.
    *
    * Treating both `this` and [other] as sufficiently large two's component
    * integers, the result is a number with only the bits set that are set in
    * both `this` and [other]
    *
    * Of both operands are negative, the result is negative, otherwise
    * the result is non-negative.
    */
   int operator &(int other);
@@ skipping 213 matching lines @@
    * sign, the [onError] is called with the [source] as argument, and its return
    * value is used instead. If no [onError] is provided, a [FormatException]
    * is thrown.
    *
    * The [onError] function is only invoked if [source] is a [String]. It is
    * not invoked if the [source] is, for example, `null`.
    */
   external static int parse(String source,
                             { int radix,
                               int onError(String source) });
-
-  /**
-   * Returns the integer value for the given environment variable
-   * [name] or [defaultValue] if [name] is not present. If the value
-   * of the environment variable is not a valid integer literal a
-   * [FormatException] is thrown.
-   */
-  external const factory int.fromEnvironment(String name, {int defaultValue});
 }