lots more tests

Author: sethladd

test/model_test.dart

@@ -168,6 +168,8 @@ void main() {
     TopLevelVariable testingCodeSyntaxInOneLiners;
 
     Class specialList;
+    Class baseForDocComments;
+    Method doAwesomeStuff;
     Class subForDocComments;
 
     ModelFunction short;
@@ -196,9 +198,72 @@ void main() {
       subForDocComments =
           fakeLibrary.classes.firstWhere((c) => c.name == 'SubForDocComments');
 
+      baseForDocComments =
+          fakeLibrary.classes.firstWhere((c) => c.name == 'BaseForDocComments');
+      doAwesomeStuff = baseForDocComments.instanceMethods
+          .firstWhere((m) => m.name == 'doAwesomeStuff');
+
       short = fakeLibrary.functions.firstWhere((f) => f.name == 'short');
     });
 
+    group('doc references', () {
+      String docsAsHtml;
+
+      setUp(() {
+        docsAsHtml = doAwesomeStuff.documentationAsHtml;
+      });
+
+      test('codeifies a class from the SDK', () {
+        expect(docsAsHtml,
+            contains('<code class="prettyprint lang-dart">String</code>'));
+      });
+
+      test('codeifies a reference to its parameter', () {
+        expect(docsAsHtml,
+            contains('<code class="prettyprint lang-dart">value</code>'));
+      });
+
+      test('links to a reference to its class', () {
+        expect(docsAsHtml, contains(
+            '<a href="fake/BaseForDocComments-class.html">BaseForDocComments</a>'));
+      });
+
+      test('links to a reference to a top-level const', () {
+        expect(
+            docsAsHtml, contains('<a href="">NAME_WITH_TWO_UNDERSCORES</a>'));
+      });
+
+      test('links to a method in this class', () {
+        expect(docsAsHtml, contains(
+            '<a href="fake/BaseForDocComments/anotherMethod.html">anotherMethod</a>'));
+      });
+
+      test('links to a top-level function in this library', () {
+        expect(docsAsHtml, contains(
+            '<a href="fake/topLevelFunction.html">topLevelFunction</a>'));
+      });
+
+      test('links to top-level function from an imported library', () {
+        expect(
+            docsAsHtml, contains('<a href="ex/function1.html">function1</a>'));
+      });
+
+      test('links to a class from an imported lib', () {
+        expect(docsAsHtml, contains('<a href="ex/Apple-class.html">Apple</a>'));
+      });
+
+      test('links to a top-level const from an imported lib', () {
+        expect(docsAsHtml, contains(
+            '<a href="fake/incorrectDocReference.html">incorrectDocReference</a>'));
+      });
+
+      test('links to a top-level variable with a prefix from an imported lib',
+          () {
+        expect(docsAsHtml,
+            contains('<a href="">css.theOnlyThingInTheLibrary</a>'));
+      });
+    });
+
     test('multi-underscore names in brackets do not become italicized', () {
       expect(short.documentation, contains('[NAME_WITH_TWO_UNDERSCORES]'));
       expect(short.documentation, contains('[NAME_SINGLEUNDERSCORE]'));

test_package/lib/fake.dart

@@ -46,6 +46,8 @@ import 'dart:collection';
 
 import 'example.dart';
 
+import 'css.dart' as css;
+
 /// Useful for annotations.
 class Annotation {
   final String value;
@@ -384,10 +386,26 @@ class ExtraSpecialList<E> extends SpecialList {}
 class BaseForDocComments {
   /// Takes a [value] and returns a String.
   ///
-  /// This methods is inside of [BaseForDocComments]
+  /// This methods is inside of [BaseForDocComments] class
+  ///
+  /// Also [NAME_WITH_TWO_UNDERSCORES] which is a top-level const
+  ///
+  /// Returns a [String]
+  ///
+  /// Reference to another method in this class [anotherMethod]
+  ///
+  /// Reference to a top-level function in this library [topLevelFunction]
   ///
-  /// Also [NAME_WITH_TWO_UNDERSCORES]
+  /// Reference to a top-level function in another library (example lib) [function1]
+  ///
+  /// Reference to a class in example lib [Apple]
+  ///
+  /// Reference to a top-level const in another library [incorrectDocReference]
+  ///
+  /// Reference to prefixed-name from another lib [css.theOnlyThingInTheLibrary]
   String doAwesomeStuff(int value) => null;
+
+  void anotherMethod() {}
 }
 
 /// Testing if docs for inherited method are correct.