pkg/docgen: fixed type references within typedef doc comments

pkg/docgen/test/multi_library_code/lib/test_lib_bar.dart

Index: pkg/docgen/test/multi_library_code/lib/test_lib_bar.dart
diff --git a/pkg/docgen/test/multi_library_code/lib/test_lib_bar.dart b/pkg/docgen/test/multi_library_code/lib/test_lib_bar.dart
index 094d554fb2f6d391f1b9949a904e5eb147debe49..6f36d9b0452ab2db46eb576573550ee9883e7106 100644
--- a/pkg/docgen/test/multi_library_code/lib/test_lib_bar.dart
+++ b/pkg/docgen/test/multi_library_code/lib/test_lib_bar.dart
@@ -5,6 +5,7 @@
 library test_lib.bar;
 
 import 'test_lib.dart';
+import 'test_lib_foo.dart';
 
 /*
  * Normal comment for class C.
@@ -12,12 +13,18 @@ import 'test_lib.dart';
 class C {
 }
 
-/// [input] is of type [C] returns an [A].
-A generateFoo(C input) {
+/// Processes an [input] of type [C] instance for testing.

[kevmoo, 2014/04/20 21:34:54]

The method and the typedef have the same signature. This makes it easy to see
where typedef is broken

+///
+/// To eliminate import warnings for [A] and to test typedefs.
+///
+/// It's important that the [List<A>] for param [listOfA] is not empty.
+A testMethod(C input, List<A> listOfA, B aBee) {
   throw 'noop';
 }
 
-/// Processes a [C] instance for testing.
+/// Processes an [input] of type [C] instance for testing.
 ///
 /// To eliminate import warnings for [A] and to test typedefs.
-typedef A AnATransformer(C other);
+///
+/// It's important that the [List<A>] for param [listOfA] is not empty.
+typedef A testTypedef(C other, List<A> listOfA, B aBee);