update docs on noSuchMethod

sdk/lib/core/object.dart

Index: sdk/lib/core/object.dart
diff --git a/sdk/lib/core/object.dart b/sdk/lib/core/object.dart
index 2951a736a0e49167395c5f9eae3cc2fa3061ec16..e03ff8e85e9bce056107107327e09c5747c59e94 100644
--- a/sdk/lib/core/object.dart
+++ b/sdk/lib/core/object.dart
@@ -78,14 +78,13 @@ class Object {
   external String toString();
 
   /**
-   * [noSuchMethod] is invoked when users invoke a non-existent method
-   * on an object. The name of the method and the arguments of the
-   * invocation are passed to [noSuchMethod] in an [Invocation].
-   * If [noSuchMethod] returns a value, that value becomes the result of
-   * the original invocation.
+   * Invoked when a non-existent method or property is accessed.
    *
-   * The default behavior of [noSuchMethod] is to throw a
-   * [NoSuchMethodError].
+   * Classes can override [noSuchMethod] to provide custom behavior.
+   *
+   * If a value is returned, it becomes the result of the original invocation.
+   *
+   * The default behavior is to throw a [NoSuchMethodError].
    */
   external dynamic noSuchMethod(Invocation invocation);