Merge pull request #1216 from dart-lang/more_references

More references

Author: devoncarew

lib/src/model.dart

@@ -1363,8 +1363,7 @@ abstract class ModelElement implements Comparable, Nameable, Documentable {
   bool get canHaveParameters =>
       element is ExecutableElement || element is FunctionTypeAliasElement;
 
-  /// Returns the docs, stripped of their
-  /// leading comments syntax.
+  /// Returns the docs, stripped of their leading comments syntax.
   ///
   /// This getter will walk up the inheritance hierarchy
   /// to find docs, if the current class doesn't have docs

testing/test_package/lib/example.dart

@@ -269,12 +269,12 @@ class PublicClassImplementsPrivateInterface implements _PrivateInterface {
   void test() {}
 }
 
-/// [Object] foo bar
+/// Foo bar.
 ///
-/// 3. All references should be hyperlinks. [Object] [MyError] [ShapeType]
-///    [MyError] [MyException]
-///    [MyError] [MyException] [Object]
-///    [ShapeType] foo bar
+/// 3. All references should be hyperlinks. [MyError] and
+///    [ShapeType] and [MyError] and [MyException] and
+///    [MyError] and [MyException] and
+///    [ShapeType] foo bar.
 class ShapeType extends _RetainedEnum {
   static const ShapeType rect = const ShapeType._internal("Rect");
   static const ShapeType ellipse = const ShapeType._internal("Ellipse");

testing/test_package/lib/fake.dart

@@ -467,3 +467,13 @@ void paintImage2(
   // nothing to do here -
 
 }
+
+/// Test operator references: [OperatorReferenceClass.==].
+class OperatorReferenceClass {
+  OperatorReferenceClass();
+
+  @override
+  bool operator ==(dynamic other) {
+    return false;
+  }
+}

testing/test_package_docs/ex/ShapeType-class.html

@@ -132,11 +132,11 @@ <h5><a href="ex/ex-library.html">ex</a></h5>
   <div class="col-xs-12 col-sm-9 col-md-8 main-content">
 
     <section class="desc markdown">
-      <p><code>Object</code> foo bar</p><ol><li>
-<p>All references should be hyperlinks. <code>Object</code> <code>MyError</code> <a href="ex/ShapeType-class.html">ShapeType</a>
-   <code>MyError</code> <code>MyException</code>
-   <code>MyError</code> <code>MyException</code> <code>Object</code>
-   <a href="ex/ShapeType-class.html">ShapeType</a> foo bar</p></li></ol>
+      <p>Foo bar.</p><ol><li>
+<p>All references should be hyperlinks. <a href="ex/MyError-class.html">MyError</a> and
+   <code>ShapeType</code> and <a href="ex/MyError-class.html">MyError</a> and <code>MyException</code> and
+   <a href="ex/MyError-class.html">MyError</a> and <code>MyException</code> and
+   <code>ShapeType</code> foo bar.</p></li></ol>
     </section>
 
 

testing/test_package_docs/ex/ex-library.html

@@ -397,7 +397,7 @@ <h2>Classes</h2>
           <span class="name "><a href="ex/ShapeType-class.html">ShapeType</a></span>
         </dt>
         <dd>
-          <p><code>Object</code> foo bar</p>
+          <p>Foo bar.</p>
         </dd>
         <dt id="SpecializedDuration">
           <span class="name "><a href="ex/SpecializedDuration-class.html">SpecializedDuration</a></span>

testing/test_package_docs/fake/Annotation-class.html

@@ -135,6 +135,7 @@ <h5><a href="fake/fake-library.html">fake</a></h5>
       <li><a href="fake/Interface-class.html">Interface</a></li>
       <li><a href="fake/LongFirstLine-class.html">LongFirstLine</a></li>
       <li><a href="fake/MixMeIn-class.html">MixMeIn</a></li>
+      <li><a href="fake/OperatorReferenceClass-class.html">OperatorReferenceClass</a></li>
       <li><a href="fake/OtherGenericsThing-class.html">OtherGenericsThing</a></li>
       <li><a href="fake/SpecialList-class.html">SpecialList</a></li>
       <li><a href="fake/SubForDocComments-class.html">SubForDocComments</a></li>

testing/test_package_docs/fake/AnotherInterface-class.html

@@ -134,6 +134,7 @@ <h5><a href="fake/fake-library.html">fake</a></h5>
       <li><a href="fake/Interface-class.html">Interface</a></li>
       <li><a href="fake/LongFirstLine-class.html">LongFirstLine</a></li>
       <li><a href="fake/MixMeIn-class.html">MixMeIn</a></li>
+      <li><a href="fake/OperatorReferenceClass-class.html">OperatorReferenceClass</a></li>
       <li><a href="fake/OtherGenericsThing-class.html">OtherGenericsThing</a></li>
       <li><a href="fake/SpecialList-class.html">SpecialList</a></li>
       <li><a href="fake/SubForDocComments-class.html">SubForDocComments</a></li>

testing/test_package_docs/fake/BaseForDocComments-class.html

@@ -135,6 +135,7 @@ <h5><a href="fake/fake-library.html">fake</a></h5>
       <li><a href="fake/Interface-class.html">Interface</a></li>
       <li><a href="fake/LongFirstLine-class.html">LongFirstLine</a></li>
       <li><a href="fake/MixMeIn-class.html">MixMeIn</a></li>
+      <li><a href="fake/OperatorReferenceClass-class.html">OperatorReferenceClass</a></li>
       <li><a href="fake/OtherGenericsThing-class.html">OtherGenericsThing</a></li>
       <li><a href="fake/SpecialList-class.html">SpecialList</a></li>
       <li><a href="fake/SubForDocComments-class.html">SubForDocComments</a></li>

testing/test_package_docs/fake/CUSTOM_CLASS-constant.html

@@ -129,6 +129,7 @@ <h5><a href="fake/fake-library.html">fake</a></h5>
       <li><a href="fake/Interface-class.html">Interface</a></li>
       <li><a href="fake/LongFirstLine-class.html">LongFirstLine</a></li>
       <li><a href="fake/MixMeIn-class.html">MixMeIn</a></li>
+      <li><a href="fake/OperatorReferenceClass-class.html">OperatorReferenceClass</a></li>
       <li><a href="fake/OtherGenericsThing-class.html">OtherGenericsThing</a></li>
       <li><a href="fake/SpecialList-class.html">SpecialList</a></li>
       <li><a href="fake/SubForDocComments-class.html">SubForDocComments</a></li>

testing/test_package_docs/fake/Callback2.html

@@ -129,6 +129,7 @@ <h5><a href="fake/fake-library.html">fake</a></h5>
       <li><a href="fake/Interface-class.html">Interface</a></li>
       <li><a href="fake/LongFirstLine-class.html">LongFirstLine</a></li>
       <li><a href="fake/MixMeIn-class.html">MixMeIn</a></li>
+      <li><a href="fake/OperatorReferenceClass-class.html">OperatorReferenceClass</a></li>
       <li><a href="fake/OtherGenericsThing-class.html">OtherGenericsThing</a></li>
       <li><a href="fake/SpecialList-class.html">SpecialList</a></li>
       <li><a href="fake/SubForDocComments-class.html">SubForDocComments</a></li>