Documentation cleanups.

sdk/lib/core/date_time.dart

 // Copyright (c) 2011, 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 instant in time, such as July 20, 1969, 8:18pm GMT.
  *
  * Create a DateTime object by using one of the constructors
@@ skipping 527 matching lines @@
    * where:
    *
    * * `yyyy` is a, possibly negative, four digit representation of the year,
    *   if the year is in the range -9999 to 9999,
    *   otherwise it is a signed six digit representation of the year.
    * * `MM` is the month in the range 01 to 12,
    * * `dd` is the day of the month in the range 01 to 31,
    * * `HH` are hours in the range 00 to 23,
    * * `mm` are minutes in the range 00 to 59,
    * * `ss` are seconds in the range 00 to 59 (no leap seconds),
-   * * `mmm` are microseconds in the range 000 to 999, and
+   * * `mmm` are milliseconds in the range 000 to 999, and
    * * `uuu` are microseconds in the range 001 to 999. If [microsecond] equals
    *   0, then this part is omitted.
    *
    * The resulting string can be parsed back using [parse].
    */
   String toIso8601String() {
     String y = (year >= -9999 && year <= 9999) ? _fourDigits(year)
                                                : _sixDigits(year);
     String m = _twoDigits(month);
     String d = _twoDigits(day);
@@ skipping 193 matching lines @@
    * In accordance with ISO 8601
    * a week starts with Monday, which has the value 1.
    *
    *     DateTime moonLanding = DateTime.parse("1969-07-20 20:18:00");
    *     assert(moonLanding.weekday == 7);
    *     assert(moonLanding.weekday == DateTime.SUNDAY);
    *
    */
   external int get weekday;
 }