Add some tests for dartdoc name reference resolution.

utils/dartdoc/dartdoc.dart

 // Copyright (c) 2011, 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.
 
 /**
  * To use it, from this directory, run:
  *
  *     $ ./dartdoc <path to .dart file>
  *
  * This will create a "docs" directory with the docs for your libraries. To
@@ skipping 86 matching lines @@
   int _totalTypes = 0;
   int _totalMembers = 0;
 
   Dartdoc()
     : _comments = new CommentMap() {
     // Patch in support for [:...:]-style code to the markdown parser.
     // TODO(rnystrom): Markdown already has syntax for this. Phase this out?
     md.InlineParser.syntaxes.insertRange(0, 1,
         new md.CodeSyntax(@'\[\:((?:.|\n)*?)\:\]'));
 
-    md.setImplicitLinkResolver(resolveNameReference);
+    md.setImplicitLinkResolver((name) => resolveNameReference(name,
+            currentLibrary: _currentLibrary, currentType: _currentType,
+            currentMember: _currentMember));
   }
 
   document(String entrypoint) {
     var oldDietParse = options.dietParse;
     try {
       options.dietParse = true;
 
       // Handle the built-in entrypoints.
       switch (entrypoint) {
         case 'corelib':
@@ skipping 655 matching lines @@
 
     // Syntax highlight.
     return classifySource(new SourceFile('', code));
   }
 
   /**
    * This will be called whenever a doc comment hits a `[name]` in square
    * brackets. It will try to figure out what the name refers to and link or
    * style it appropriately.
    */
-  md.Node resolveNameReference(String name) {
+  md.Node resolveNameReference(String name, [Member currentMember = null,

[Bob Nystrom, 2012/01/09 22:48:20]

I wouldn't use "current", just "member", "type" and "library".

+      Type currentType = null, Library currentLibrary = null]) {
     makeLink(String href) {
       final anchor = new md.Element.text('a', name);
       anchor.attributes['href'] = relativePath(href);
       anchor.attributes['class'] = 'crossref';
       return anchor;
     }
 
     findMember(Type type) {
       final member = type.members[name];
       if (member == null) return null;
 
       // Special case: if the member we've resolved is a property (i.e. it wraps
       // a getter and/or setter then *that* member itself won't be on the docs,
       // just the getter or setter will be. So pick one of those to link to.
       if (member.isProperty) {
         return member.canGet ? member.getter : member.setter;
       }
 
       return member;
     }
 
     // See if it's a parameter of the current method.
-    if (_currentMember != null) {
-      for (final parameter in _currentMember.parameters) {
+    if (currentMember != null) {
+      for (final parameter in currentMember.parameters) {
         if (parameter.name == name) {
           final element = new md.Element.text('span', name);
           element.attributes['class'] = 'param';
           return element;
         }
       }
     }
 
     // See if it's another member of the current type.
-    if (_currentType != null) {
-      final member = findMember(_currentType);
+    if (currentType != null) {
+      final member = findMember(currentType);
       if (member != null) {
         return makeLink(memberUrl(member));
       }
     }
 
     // See if it's another type in the current library.
-    if (_currentLibrary != null) {
-      final type = _currentLibrary.types[name];
+    if (currentLibrary != null) {
+      final type = currentLibrary.types[name];
       if (type != null) {
         return makeLink(typeUrl(type));
       }
 
       // See if it's a top-level member in the current library.
-      final member = findMember(_currentLibrary.topType);
+      final member = findMember(currentLibrary.topType);
       if (member != null) {
         return makeLink(memberUrl(member));
       }
     }
 
     // TODO(rnystrom): Should also consider:
     // * Names imported by libraries this library imports.
     // * Type parameters of the enclosing type.
 
     return new md.Element.text('code', name);
   }
 
   // TODO(rnystrom): Move into SourceSpan?
   int getSpanColumn(SourceSpan span) {
     final line = span.file.getLine(span.start);
     return span.file.getColumn(line, span.start);
   }
 }