Clean patch implementation.

sdk/lib/_internal/compiler/implementation/elements/elements.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.
 
 library elements;
 
 
 import '../tree/tree.dart';
 import '../util/util.dart';
 import '../resolution/resolution.dart';
@@ skipping 229 matching lines @@
   CompilationUnitElement getCompilationUnit();
   LibraryElement getLibrary();
   LibraryElement getImplementationLibrary();
   ClassElement getEnclosingClass();
   Element getEnclosingClassOrCompilationUnit();
   Element getEnclosingMember();
   Element getOutermostEnclosingMemberOrTopLevel();
 
   FunctionElement asFunctionElement();
 
+  /// Is [:true:] if this element has a corresponding patch.
+  ///
+  /// If [:true:] this element has a non-null [patch] field.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
   bool get isPatched;
+
+  /// Is [:true:] if this element is a patch.
+  ///
+  /// If [:true:] this element has a non-null [origin] field.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
   bool get isPatch;
+
+  /// Is [:true:] if this element defines the implementation for the entity of
+  /// this element.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
   bool get isImplementation;
+
+  /// Is [:true:] if this element introduces the entity of this element.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
   bool get isDeclaration;
+
+  /// Returns the element which defines the implementation for the entity of
+  /// this element.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
+  Element get implementation;
+
+  /// Returns the element which introduces the entity of this element.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
+  Element get declaration;
+
+  /// Returns the patch for this element if this element is patched.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
+  Element get patch;
+
+  /// Returns the origin for this element if this element is a patch.
+  ///
+  /// See [:patch_parser.dart:] for a description of the terminology.
+  Element get origin;
+
   bool get isSynthesized;
   bool get isForwardingConstructor;
   bool get isMixinApplication;
 
-  Element get implementation;
-  Element get declaration;
-  Element get patch;
-  Element get origin;
-
   bool hasFixedBackendName();
   String fixedBackendName();
 
   bool get isAbstract;
   bool isForeign(Compiler compiler);
 
   void addMetadata(MetadataAnnotation annotation);
   void setNative(String name);
   void setFixedBackendName(String name);
 
@@ skipping 562 matching lines @@
   /// element.
   AbstractFieldElement get abstractField;
 
   /**
    * Compute the type of the target of a constructor for an instantiation site
    * with type [:newType:].
    */
   InterfaceType computeTargetType(InterfaceType newType);
 
   // TODO(kasperl): These are bit fishy. Do we really need them?
-  void set patch(FunctionElement value);
-  void set origin(FunctionElement value);
   void set defaultImplementation(FunctionElement value);
 
   /// Do not use [computeSignature] outside of the resolver; instead retrieve
   /// the signature through the [functionSignature] field.
   /// Trying to access a function signature that has not been computed in
   /// resolution is an error and calling [computeSignature] covers that error.
   /// This method will go away!
   @deprecated FunctionSignature computeSignature(Compiler compiler);
 
   FunctionExpression parseNode(DiagnosticListener listener);
@@ skipping 51 matching lines @@
   String get nativeTagInfo;
 
   bool get isMixinApplication;
   bool get isUnnamedMixinApplication;
   bool get hasBackendMembers;
   bool get hasLocalScopeMembers;
 
   // TODO(kasperl): These are bit fishy. Do we really need them?
   void set supertype(DartType value);
   void set interfaces(Link<DartType> value);
-  void set patch(ClassElement value);
-  void set origin(ClassElement value);
   void set supertypeLoadState(int value);
   void set resolutionState(int value);
   void set nativeTagInfo(String value);
 
   bool isObject(Compiler compiler);
   bool isSubclassOf(ClassElement cls);
   /// Returns true if `this` explicitly/nominally implements [intrface].
   ///
   /// Note that, if [intrface] is the `Function` class, this method returns
   /// falso for a class that has a `call` method but does not explicitly
@@ skipping 208 matching lines @@
   bool get isDeclaredByField;
 
   /// Returns `true` if this member is abstract.
   bool get isAbstract;
 
   /// If abstract, [implementation] points to the overridden concrete member,
   /// if any. Otherwise [implementation] points to the member itself.
   Member get implementation;
 }