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

lib/i18n/bidi_utils.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.
 
-#library('bidi_utils');
-
 /**
  * Bidi stands for Bi-directional text.
  * According to http://en.wikipedia.org/wiki/Bi-directional_text:
  * Bi-directional text is text containing text in both text directionalities,
  * both right-to-left (RTL) and left-to-right (LTR). It generally involves text
  * containing different types of alphabets, but may also refer to boustrophedon,
  * which is changing text directionality in each row.
  *
  * This file provides some utility classes for determining directionality of
  * text, switching CSS layout from LTR to RTL, and other normalizing utilities
  * needed when switching between RTL and LTR formatting.
  *
  * It defines the TextDirection class which is used to represent directionality
  * of text,
  * In most cases, it is preferable to use bidi_formatter.dart, which provides
  * bidi functionality in the given directional context, instead of using
  * bidi_utils.dart directly.
  */
-
-/** Class containing constants to represent the directionality of text. */
 class TextDirection {
   static final LTR = const TextDirection._('LTR', 'ltr');
   static final RTL = const TextDirection._('RTL', 'rtl');
   // If the directionality of the text cannot be determined and we are not using
   // the context direction (or if the context direction is unknown), then the
   // text falls back on the more common ltr direction.
   static final UNKNOWN = const TextDirection._('UNKNOWN', 'ltr');
 
   /** 
    * Textual representation of the directionality constant. One of 
@@ skipping 351 matching lines @@
 
   /**
    * Check the directionality of [str], return true if the piece of
    * text should be laid out in RTL direction. If [isHtml] is true, the string
    * is HTML or HTML-escaped.
    */
   static bool detectRtlDirectionality(String str, [bool isHtml]) {
     return estimateDirection(str, isHtml) == TextDirection.RTL;
   }
 }