pkg/docgen: the big refactor

pkg/docgen/test/multi_library_code/lib/test_lib_bar.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 test_lib.bar;
 
 import 'test_lib.dart';
 
 /*
  * Normal comment for class C.
  */
 class C {
 }
 
 /// [input] is of type [C] returns an [A].
 A generateFoo(C input) {
   throw 'noop';
 }
 
 /// Processes a [C] instance for testing.
 ///
 /// To eliminate import warnings for [A] and to test typedefs.
 typedef A AnATransformer(C other);