Revert "Remove 'Element.docRange'."

pkg/analyzer/lib/src/dart/element/element.dart

 // Copyright (c) 2014, 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 analyzer.src.dart.element.element;
 
 import 'dart:collection';
 import 'dart:math' show min;
 
 import 'package:analyzer/dart/ast/ast.dart';
@@ skipping 566 matching lines @@
   void set constructors(List<ConstructorElement> constructors) {
     assert(_unlinkedClass == null);
     assert(!isMixinApplication);
     for (ConstructorElement constructor in constructors) {
       (constructor as ConstructorElementImpl).enclosingElement = this;
     }
     this._constructors = constructors;
   }
 
   @override
+  SourceRange get docRange {
+    if (_unlinkedClass != null) {
+      UnlinkedDocumentationComment comment =
+          _unlinkedClass.documentationComment;
+      return comment != null
+          ? new SourceRange(comment.offset, comment.length)
+          : null;
+    }
+    return super.docRange;
+  }
+
+  @override
   String get documentationComment {
     if (_unlinkedClass != null) {
       return _unlinkedClass?.documentationComment?.text;
     }
     return super.documentationComment;
   }
 
   /**
    * Return `true` if [CompileTimeErrorCode.MIXIN_HAS_NO_CONSTRUCTORS] should
    * be reported for this class.
@@ skipping 1198 matching lines @@
  */
 class ConstFieldElementImpl_EnumValue extends ConstFieldElementImpl_ofEnum {
   final UnlinkedEnumValue _unlinkedEnumValue;
   final int _index;
 
   ConstFieldElementImpl_EnumValue(
       EnumElementImpl enumElement, this._unlinkedEnumValue, this._index)
       : super(enumElement);
 
   @override
+  SourceRange get docRange {
+    if (_unlinkedEnumValue != null) {
+      UnlinkedDocumentationComment comment =
+          _unlinkedEnumValue.documentationComment;
+      return comment != null
+          ? new SourceRange(comment.offset, comment.length)
+          : null;
+    }
+    return super.docRange;
+  }
+
+  @override
   String get documentationComment {
     if (_unlinkedEnumValue != null) {
       return _unlinkedEnumValue?.documentationComment?.text;
     }
     return super.documentationComment;
   }
 
   @override
   EvaluationResultImpl get evaluationResult {
     if (_evaluationResult == null) {
@@ skipping 847 matching lines @@
    * A cached copy of the calculated location for this element.
    */
   ElementLocation _cachedLocation;
 
   /**
    * The documentation comment for this element.
    */
   String _docComment;
 
   /**
+   * The offset to the beginning of the documentation comment,
+   * or `null` if this element does not have a documentation comment.
+   */
+  int _docRangeOffset;
+
+  /**
+   * The length of the documentation comment range for this element.
+   */
+  int _docRangeLength;
+
+  /**
    * The offset of the beginning of the element's code in the file that contains
    * the element, or `null` if the element is synthetic.
    */
   int _codeOffset;
 
   /**
    * The length of the element's code, or `null` if the element is synthetic.
    */
   int _codeLength;
 
@@ skipping 32 matching lines @@
     if (_enclosingElement == null) {
       return null;
     }
     return _enclosingElement.context;
   }
 
   @override
   String get displayName => _name;
 
   @override
+  SourceRange get docRange {
+    if (_docRangeOffset != null && _docRangeLength != null) {
+      return new SourceRange(_docRangeOffset, _docRangeLength);
+    }
+    return null;
+  }
+
+  @override
   String get documentationComment => _docComment;
 
   /**
    * The documentation comment source for this element.
    */
   void set documentationComment(String doc) {
     assert(!isResynthesized);
     _docComment = doc?.replaceAll('\r\n', '\n');
   }
 
@@ skipping 324 matching lines @@
   /**
    * Set the code range for this element.
    */
   void setCodeRange(int offset, int length) {
     assert(!isResynthesized);
     _codeOffset = offset;
     _codeLength = length;
   }
 
   /**
+   * Set the documentation comment source range for this element.
+   */
+  void setDocRange(int offset, int length) {
+    assert(!isResynthesized);
+    _docRangeOffset = offset;
+    _docRangeLength = length;
+  }
+
+  /**
    * Set whether the given [modifier] is associated with this element to
    * correspond to the given [value].
    */
   void setModifier(Modifier modifier, bool value) {
     _modifiers = BooleanArray.setEnum(_modifiers, modifier, value);
   }
 
   @override
   String toString() {
     StringBuffer buffer = new StringBuffer();
@@ skipping 265 matching lines @@
   @override
   List<ConstructorElement> get constructors {
     // The equivalent code for enums in the spec shows a single constructor,
     // but that constructor is not callable (since it is a compile-time error
     // to subclass, mix-in, implement, or explicitly instantiate an enum).
     // So we represent this as having no constructors.
     return const <ConstructorElement>[];
   }
 
   @override
+  SourceRange get docRange {
+    if (_unlinkedEnum != null) {
+      UnlinkedDocumentationComment comment = _unlinkedEnum.documentationComment;
+      return comment != null
+          ? new SourceRange(comment.offset, comment.length)
+          : null;
+    }
+    return super.docRange;
+  }
+
+  @override
   String get documentationComment {
     if (_unlinkedEnum != null) {
       return _unlinkedEnum?.documentationComment?.text;
     }
     return super.documentationComment;
   }
 
   @override
   List<FieldElement> get fields {
     if (_unlinkedEnum != null && _fields == null) {
@@ skipping 233 matching lines @@
 
   @override
   String get displayName {
     if (serializedExecutable != null) {
       return serializedExecutable.name;
     }
     return super.displayName;
   }
 
   @override
+  SourceRange get docRange {
+    if (serializedExecutable != null) {
+      UnlinkedDocumentationComment comment =
+          serializedExecutable.documentationComment;
+      return comment != null
+          ? new SourceRange(comment.offset, comment.length)
+          : null;
+    }
+    return super.docRange;
+  }
+
+  @override
   String get documentationComment {
     if (serializedExecutable != null) {
       return serializedExecutable?.documentationComment?.text;
     }
     return super.documentationComment;
   }
 
   /**
    * Set whether this executable element is external.
    */
@@ skipping 946 matching lines @@
     if (_unlinkedTypedef != null) {
       return _unlinkedTypedef.codeRange?.offset;
     }
     return super.codeOffset;
   }
 
   @override
   String get displayName => name;
 
   @override
+  SourceRange get docRange {
+    if (_unlinkedTypedef != null) {
+      UnlinkedDocumentationComment comment =
+          _unlinkedTypedef.documentationComment;
+      return comment != null
+          ? new SourceRange(comment.offset, comment.length)
+          : null;
+    }
+    return super.docRange;
+  }
+
+  @override
   String get documentationComment {
     if (_unlinkedTypedef != null) {
       return _unlinkedTypedef?.documentationComment?.text;
     }
     return super.documentationComment;
   }
 
   @override
   CompilationUnitElement get enclosingElement =>
       super.enclosingElement as CompilationUnitElement;
@@ skipping 737 matching lines @@
    * Set the compilation unit that defines this library to the given compilation
    * [unit].
    */
   void set definingCompilationUnit(CompilationUnitElement unit) {
     assert((unit as CompilationUnitElementImpl).librarySource == unit.source);
     (unit as CompilationUnitElementImpl).enclosingElement = this;
     this._definingCompilationUnit = unit;
   }
 
   @override
+  SourceRange get docRange {
+    if (_unlinkedDefiningUnit != null) {
+      UnlinkedDocumentationComment comment =
+          _unlinkedDefiningUnit.libraryDocumentationComment;
+      return comment != null
+          ? new SourceRange(comment.offset, comment.length)
+          : null;
+    }
+    return super.docRange;
+  }
+
+  @override
   String get documentationComment {
     if (_unlinkedDefiningUnit != null) {
       return _unlinkedDefiningUnit?.libraryDocumentationComment?.text;
     }
     return super.documentationComment;
   }
 
   FunctionElement get entryPoint {
     if (resynthesizerContext != null) {
       _entryPoint ??= resynthesizerContext.findEntryPoint();
@@ skipping 1013 matching lines @@
    * list of [conflictingElements].
    */
   MultiplyDefinedElementImpl(this.context, this.conflictingElements) {
     _name = conflictingElements[0].name;
   }
 
   @override
   String get displayName => _name;
 
   @override
+  SourceRange get docRange => null;
+
+  @override
   String get documentationComment => null;
 
   @override
   Element get enclosingElement => null;
 
   @override
   bool get isDeprecated => false;
 
   @override
   bool get isFactory => false;
@@ skipping 263 matching lines @@
     return super.codeOffset;
   }
 
   @override
   void set const3(bool isConst) {
     assert(_unlinkedVariable == null);
     super.const3 = isConst;
   }
 
   @override
+  SourceRange get docRange {
+    if (_unlinkedVariable != null) {
+      UnlinkedDocumentationComment comment =
+          _unlinkedVariable.documentationComment;
+      return comment != null
+          ? new SourceRange(comment.offset, comment.length)
+          : null;
+    }
+    return super.docRange;
+  }
+
+  @override
   String get documentationComment {
     if (_unlinkedVariable != null) {
       return _unlinkedVariable?.documentationComment?.text;
     }
     return super.documentationComment;
   }
 
   @override
   void set final2(bool isFinal) {
     assert(_unlinkedVariable == null);
@@ skipping 1710 matching lines @@
 
   @override
   void visitElement(Element element) {
     int offset = element.nameOffset;
     if (offset != -1) {
       map[offset] = element;
     }
     super.visitElement(element);
   }
 }