Changes to the i18n messages so that they are invoked as

lib/i18n/intl_message.dart

Index: lib/i18n/intl_message.dart
===================================================================
--- lib/i18n/intl_message.dart	(revision 8458)
+++ lib/i18n/intl_message.dart	(working copy)
@@ -7,14 +7,20 @@
  *
  *
  * _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.'''',