Convert pub tests to line doc comments.

utils/tests/pub/version_solver_test.dart

 // Copyright (c) 2012, 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 pub_update_test;
 
 import 'dart:io';
 import 'dart:isolate';
 
 import '../../pub/lock_file.dart';
@@ skipping 443 matching lines @@
     if (error == null) {
       future.handleException((ex) {
         print(ex);
         print(future.stackTrace);
         return true;
       });
     }
   });
 }
 
-/**
- * A source used for testing. This both creates mock package objects and acts as
- * a source for them.
- *
- * In order to support testing packages that have the same name but different
- * descriptions, a package's name is calculated by taking the description string
- * and stripping off any trailing hyphen followed by non-hyphen characters.
- */
+/// A source used for testing. This both creates mock package objects and acts
+/// as a source for them.
+///
+/// In order to support testing packages that have the same name but different
+/// descriptions, a package's name is calculated by taking the description
+/// string and stripping off any trailing hyphen followed by non-hyphen
+/// characters.
 class MockSource extends Source {
   final Map<String, Map<Version, Package>> _packages;
 
   final String name;
   bool get shouldCache => true;
 
   MockSource(this.name)
       : _packages = <String, Map<Version, Package>>{};
 
   Future<List<Version>> getVersions(String name, String description) {
@@ skipping 26 matching lines @@
         description, new Version.parse(version), dependencies);
     return new Package.inMemory(pubspec);
   }
 
   void addPackage(Package package) {
     _packages.putIfAbsent(package.name, () => new Map<Version, Package>());
     _packages[package.name][package.version] = package;
   }
 }
 
-/**
- * A source used for testing that doesn't natively understand versioning,
- * similar to how the Git and SDK sources work.
- */
+/// A source used for testing that doesn't natively understand versioning,
+/// similar to how the Git and SDK sources work.
 class MockVersionlessSource extends Source {
   final Map<String, Package> _packages;
 
   final String name = 'versionless';
   final bool shouldCache = false;
 
   MockVersionlessSource()
     : _packages = <String, Package>{};
 
   Future<bool> install(PackageId id, String path) {
@@ skipping 22 matching lines @@
   var match = new RegExp(r"(.*) from (.*)").firstMatch(name);
   if (match == null) return new Pair<String, Source>(name, source1);
   switch (match[2]) {
   case 'mock1': return new Pair<String, Source>(match[1], source1);
   case 'mock2': return new Pair<String, Source>(match[1], source2);
   case 'root': return new Pair<String, Source>(match[1], rootSource);
   case 'versionless':
     return new Pair<String, Source>(match[1], versionlessSource);
   }
 }