Revert "Remove @deprecated features."

pkg/intl/lib/bidi_formatter.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 intl;
 
 /**
  * Bidi stands for Bi-directional text.
  * According to [Wikipedia](http://en.wikipedia.org/wiki/Bi-directional_text):
  * Bi-directional text is text containing text in both text directionalities,
@@ skipping 64 matching lines @@
       _alwaysSpan = alwaysSpan;
   BidiFormatter.RTL([alwaysSpan=false]) : contextDirection = TextDirection.RTL,
       _alwaysSpan = alwaysSpan;
   BidiFormatter.UNKNOWN([alwaysSpan=false]) :
       contextDirection = TextDirection.UNKNOWN, _alwaysSpan = alwaysSpan;
 
   /** Is true if the known context direction for this formatter is RTL. */
   bool get isRTL => contextDirection == TextDirection.RTL;
 
   /**
+   * Escapes HTML-special characters of [text] so that the result can be
+   * included verbatim in HTML source code, either in an element body or in an
+   * attribute value.
+   *
+   * *htmlEscape* is deprecated. Use [HtmlEscape] from the `dart:convert`
+   * package. *htmlEscape* will be removed the 30th of September 2013.
+   */
+  // TODO(kevmoo) Remove this!
+  @deprecated
+  String htmlEscape(String text) => HTML_ESCAPE.convert(text);
+
+  /**
    * Formats a string of a given (or estimated, if not provided)
    * [direction] for use in HTML output of the context directionality, so
    * an opposite-directionality string is neither garbled nor garbles what
    * follows it.
    * If the input string's directionality doesn't match the context
    * directionality, we wrap it with a `span` tag and add a `dir` attribute
    * (either "dir=rtl" or "dir=ltr").
    * If alwaysSpan was true when constructing the formatter, the input is always
    * wrapped with `span` tag, skipping the dir attribute when it's not needed.
    *
@@ skipping 80 matching lines @@
       if (contextDirection == TextDirection.LTR) {
         return Bidi.LRM;
       } else {
         return Bidi.RLM;
       }
     } else {
       return '';
     }
   }
 }