Changes to the i18n messages so that they are invoked as

lib/i18n/intl_message.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.
 
 /**
  * Message/plural format library with locale support.
  *
  *
  * _message example:
- *    '''I see ${intl.plural(num_people,
+ *    '''I see ${Intl.plural(num_people,
  *             {'0': 'no one at all',
  *              '1': 'one other person',
  *              'other': '$num_people other people'})} in $place.''''
  *
- * Useage example:
- *      msg(num_people, place) => new IntlMessage(
-            '''I see ${intl.plural(num_people,
+ * Usage examples:
+ *      today(date) => intl.message(
+ *          "Today's date is $date",
+ *          desc: 'Indicate the current date',
+ *          examples: {'date' : 'June 8, 2012'});

[Emily Fortuna, 2012/06/08 21:50:37]

I'd recommend not using a date in this example because date formatting is a
whole different animal....

[Alan Knight, 2012/06/08 22:04:53]

I thought it was actually good to start having examples with them. It'll just
use the default format, but that's true for numbers, too. 

[Emily Fortuna, 2012/06/08 22:09:40]

Yeah, but technically, you should probably say something like "Today's date is
${DateFormat.format("yM", date)}" which just seems more trouble to explain than
it's worth.

[Alan Knight, 2012/06/08 22:14:21]

But on the same basis, below I should probably write ${NumFormat.format('i',
num_people)}, which is similarly too much. I figured it's all right to put in
something that just uses a default, especially for the moment, and explain the
more complicated parts as they come up, or in more fully worked out examples.

[Emily Fortuna, 2012/06/08 22:17:14]

Fine. The difference being we have an API already written for DateFormat, but
not for NumberFormat...

+ *      print(today(new Date.now());
+ *
+ *      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.'''',
  *          desc: 'Description of how many people are seen as program start.',
  *          examples: {'num_people': 3, 'place': 'London'});
  *
  * Calling `msg({'num_people': 2, 'place': 'Athens'});` would
  * produce "I see 2 other people in Athens." as output.
  * <!-- TODO(efortuna): documentation example involving the offset parameter.
  * -->
@@ skipping 37 matching lines @@
    * concatenation.
    */
   IntlMessage(this._message, [final String desc='', final Map examples=const {},
               final String locale='']) {
     this._messageDescription = desc;
     this._messageExamples = examples;
     this._languageCode = locale;
   }
 
 }