Add intl to apidoc, and some minor comment formatting cleanup.

lib/i18n/date_format.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.
 
 /**
  * DateFormat is for formatting and parsing dates in a locale-sensitive
  * manner.
  * It allows the user to choose from a set of standard date time formats as well
  * as specify a customized pattern under certain locales. Date elements that
  * vary across locales include month name, week name, field order, etc.
@@ skipping 28 matching lines @@
  *     K        hour in am/pm (0~11)   (Number)            0
  *     z        time zone              (Text)              Pacific Standard Time
  *     Z        time zone (RFC 822)    (Number)            -0800
  *     v        time zone (generic)    (Text)              Pacific Time
  *     '        escape for text        (Delimiter)         'Date='
  *     ''       single quote           (Literal)           'o''clock'
  *
  * Items marked with '#' work differently than in Java.
  *
  * The count of pattern letters determine the format.
- * **Text**: 
+ *
+ * **Text**:
+ *
  * * 4 or more pattern letters--use full form,
  * * less than 4--use short or abbreviated form if one exists.
  * In parsing, we will always try long format, then short.
  * (e.g., "EEEE" produces "Monday", "EEE" produces "Mon")
  *
  * **Number**: the minimum number of digits. Shorter numbers are zero-padded to
  * this amount (e.g. if "m" produces "6", "mm" produces "06"). Year is handled
  * specially; that is, if the count of 'y' is 2, the Year will be truncated to
  * 2 digits. (e.g., if "yyyy" produces "1997", "yy" produces "97".) Unlike other
  * fields, fractional seconds are padded on the right with zero.
@@ skipping 39 matching lines @@
  * runs are parsed specially. For example, the format "HHmmss" parses the input
  * text "123456" to 12:34:56, parses the input text "12345" to 1:23:45, and
  * fails to parse "1234". In other words, the leftmost field of the run is
  * flexible, while the others keep a fixed width. If the parse fails anywhere in
  * the run, then the leftmost field is shortened by one character, and the
  * entire run is parsed again. This is repeated until either the parse succeeds
  * or the leftmost field is one character in length. If the parse still fails at
  * that point, the parse of the run fails.
  */
 
-#library('date_format');
-
 class DateFormat {
 
   /** Definition of how this object formats dates. */
   String _formatDefinition;
 
   /**
    * The locale code with which the message is to be formatted (such as en-CA).
    */
   String _locale;
 
   /**
    * Date/Time format "skeleton" patterns. Also specifiable by String, but
    * written this way so that they can be discoverable via autocomplete. These
    * follow the ICU syntax described at the top of the file. These skeletons can
    * be combined and we will attempt to find the best format for each locale
    * given the pattern.
    */
    // TODO(efortuna): Hear back from i18n about Time Zones and the "core set"
-   // of skeleton patterns.
+   // of skeleton patterns. When this is complete, also properly comment these
+   // so the documentation is available on api_docs.
                                           // Example of how this looks in the US
                                           // locale.
   static final String Hm = 'Hm';          // HH:mm
   static final String Hms = 'Hms';        // HH:mm:ss
   static final String M = 'M';            // L
   static final String MEd = 'MEd';        // E, M/d
   static final String MMM = 'MMM';        // LLL
   static final String MMMEd = 'MMMEd';    // E, MMM d
   static final String MMMMEd = 'MMMMEd';  // E, MMMM d
   static final String MMMMd = 'MMMMd';    // MMMM d
@@ skipping 106 matching lines @@
 
   /**
    * Formats a string indicating how long ago (negative [duration]) or how far
    * in the future (positive [duration]) some time is with respect to a
    * reference [date].
    */
   String formatDurationFrom(Duration duration, Date date) {
     return '';
   }
 }