Add an examples getter for all Message objects in Intl

pkg/intl/lib/src/intl_message.dart

 // Copyright (c) 2013, 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 provides classes to represent the internal structure of the
  * arguments to `Intl.message`. It is used when parsing sources to extract
  * messages or to generate code for message substitution. Normal programs
  * using Intl would not import this library.
  *
@@ skipping 43 matching lines @@
   Message parent;
 
   Message(this.parent);
 
   /**
    * We find the arguments from the top-level [MainMessage] and use those to
    * do variable substitutions.
    */
   get arguments => parent == null ? const [] : parent.arguments;
 
+  /**
+   * We find the examples from the top-level [MainMessage] and use those

[Emily Fortuna, 2014/01/09 23:10:32]

does this comment make sense, because according to line 50, [MainMessage] is not
contained inside a parent...

[Alan Knight, 2014/01/10 18:44:28]

But MainMessage has an examples field that overrides this. Added a line to the
comment to clarify.

+   * when writing out variables.
+   */
+  get examples => parent == null ? const [] : parent.examples;
+
   String checkValidity(MethodInvocation node, List arguments,
                        String outerName, FormalParameterList outerArgs) {
     var hasArgs = arguments.any(
         (each) => each is NamedExpression && each.name.label.name == 'args');
     var hasParameters = !outerArgs.parameters.isEmpty;
     if (!hasArgs && hasParameters) {
       return "The 'args' argument for Intl.message must be specified";
     }
 
     var messageName = arguments.firstWhere(
@@ skipping 587 matching lines @@
     out.write('(');
     out.write(mainArgument);
     var args = codeAttributeNames;
     out.write(", {");
     args.fold(out, (buffer, arg) => buffer..write(
         "'$arg': '${this[arg].toCode()}', "));
     out.write("})}");
     return out.toString();
   }
 }