Write a README for the Intl package

pkg/intl/lib/intl.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.
 
 /**
  * This library provides internationalization and localization. This includes
  * message formatting and replacement, date and number formatting and parsing,
  * and utilities for working with Bidirectional text.
  *
- * ## Installing ##
- *
- * Use [pub][] to install this package. Add the following to your `pubspec.yaml`
- * file.
- *
- *     dependencies:
- *       intl: any
- *
- * Then run `pub install`.
- *
- * For more information, see the
- * [intl package on pub.dartlang.org](http://pub.dartlang.org/packages/intl).
+ * This is part of the [intl package]
+ * (http://pub.dartlang.org/packages/intl).
  *
  * For things that require locale or other data, there are multiple different
  * ways of making that data available, which may require importing different
  * libraries. See the class comments for more details.
  *
  * There is also a simple example application that can be found in the
- * `example/basic` directory.
- *
- * [pub]: http://pub.dartlang.org
+ * [example/basic]
+ * (https://code.google.com/p/dart/source/browse/#svn%2Fbranches%2Fbleeding_edge%2Fdart%2Fpkg%2Fintl%2Fexample%2Fbasic)
+ *  directory.
  */
 library intl;
 
 import 'dart:collection';
 import 'dart:convert';
 import 'src/intl_helpers.dart';
 import 'dart:math';
 import 'date_symbols.dart';
 import 'src/date_format_internal.dart';
 import "number_symbols.dart";
@@ skipping 18 matching lines @@
  *                '1': 'one other person',
  *                'other': '$num_people other people'})} in $place.''''
  *
  * Usage examples:
  *      today(date) => Intl.message(
  *          "Today's date is $date",
  *          name: 'today',
  *          args: [date],
  *          desc: 'Indicate the current date',
  *          examples: {'date' : 'June 8, 2012'});
- *      print(today(new DateTime.now());
+ *      print(today(new DateTime.now().toString());
  *
  *      msg(num_people, place) => Intl.message(
  *           '''I see ${Intl.plural(num_people,
  *             {'0': 'no one at all',
  *              '1': 'one other person',
  *              'other': '$num_people other people'})} in $place.''',
  *          name: 'msg',
  *          args: [num_people, place],
  *          desc: 'Description of how many people are seen as program start.',
  *          examples: {'num_people': 3, 'place': 'London'});
  *
  * Calling `msg(2, 'Athens');` would
  * produce "I see 2 other people in Athens." as output in the default locale.
  *
- * To use a locale other than the default, use the `withLocale` function.
  * You can set the default locale.
  *       Intl.defaultLocale = "pt_BR";
  *
  * To temporarily use a locale other than the default, use the `withLocale`
  * function.
  *       var todayString = new DateFormat("pt_BR").format(new DateTime.now());
  *       print(withLocale("pt_BR", () => today(todayString));
  *
  * See `tests/message_format_test.dart` for more examples.
  */
@@ skipping 267 matching lines @@
    * unless for some reason this gets called inside a message that resets the
    * locale.
    */
   static String getCurrentLocale() {
     if (defaultLocale == null) defaultLocale = systemLocale;
     return defaultLocale;
   }
 
   toString() => "Intl($locale)";
 }