ClassMirror.mixin

sdk/lib/mirrors/mirrors.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.
 
 // For the purposes of the mirrors library, we adopt a naming
 // convention with respect to getters and setters.  Specifically, for
 // some variable or field...
 //
 //   var myField;
 //
@@ skipping 200 matching lines @@
    * library 'library' is 'library.Class.method'.
    *
    * Returns a [Symbol] constructed from a string representing the
    * fully qualified name of the reflectee.
    * Let *o* be the [owner] of this mirror, let *r* be the reflectee of
    * this mirror, let *p* be the fully qualified
    * name of the reflectee of *o*, and let *s* be the simple name of *r*
    * computed by [simpleName].
    * The fully qualified name of *r* is the
    * concatenation of *p*, '.', and *s*.
+   *
+   * Because an isolate can contain more than one library with the same name (at
+   * different URIs), a fully-qualified name does not uniquely identify any
+   * language entity.
    */
   Symbol get qualifiedName;
 
   /**
-   * A mirror on the owner of this function.  This is the declaration
+   * A mirror on the owner of this Dart language entity. This is the declaration
    * immediately surrounding the reflectee.
    *
    * For a library, the owner is [:null:].
    * For a class declaration, typedef or top level function 
    * or variable, the owner is the enclosing library. 
    * For a mixin application *S with M*, the owner is the owner
    * of *M*.
    * For class Null, the owner is the dart:core library.
    * For a constructor, the owner is the immediately enclosing class.
    * For a method, instance variable or
@@ skipping 1082 matching lines @@
    *
    * When used as metadata on an import of "dart:mirrors", this metadata does
    * not apply to the library in which the annotation is used, but instead
    * applies to the other libraries (all libraries if "*" is used).
    */
   final override;
 
   const MirrorsUsed(
       {this.symbols, this.targets, this.metaTargets, this.override});
 }