Convert /** comments to /// in pub.

utils/pub/pubspec.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 pubspec;
 
 import 'package.dart';
 import 'source.dart';
 import 'source_registry.dart';
 import 'utils.dart';
 import 'version.dart';
 import 'yaml/yaml.dart';
 
-/**
- * The parsed and validated contents of a pubspec file.
- */
+/// The parsed and validated contents of a pubspec file.
 class Pubspec {
-  /**
-   * This package's name.
-   */
+  /// This package's name.
   final String name;
 
-  /**
-   * This package's version.
-   */
+  /// This package's version.
   final Version version;
 
-  /**
-   * The packages this package depends on.
-   */
+  /// The packages this package depends on.
   final List<PackageRef> dependencies;
 
   /// All pubspec fields. This includes the fields from which other properties
   /// are derived.
   final Map<String, Object> fields;
 
   Pubspec(this.name, this.version, this.dependencies,
       [Map<String, Object> fields])
     : this.fields = fields == null ? {} : fields;
 
   Pubspec.empty()
     : name = null,
       version = Version.none,
       dependencies = <PackageRef>[],
       fields = {};
 
-  /** Whether or not the pubspec has no contents. */
+  /// Whether or not the pubspec has no contents. 
   bool get isEmpty =>
     name == null && version == Version.none && dependencies.isEmpty;
 
-  /**
-   * Parses the pubspec whose text is [contents]. If the pubspec doesn't define
-   * version for itself, it defaults to [Version.none].
-   */
+  /// Parses the pubspec whose text is [contents]. If the pubspec doesn't define
+  /// version for itself, it defaults to [Version.none].
   factory Pubspec.parse(String contents, SourceRegistry sources) {
     var name = null;
     var version = Version.none;
 
     if (contents.trim() == '') return new Pubspec.empty();
 
     var parsedPubspec = loadYaml(contents);
     if (parsedPubspec == null) return new Pubspec.empty();
 
     if (parsedPubspec is! Map) {
@@ skipping 118 matching lines @@
           'Dependency specification $spec should be a string or a mapping.');
     }
 
     source.validateDescription(description, fromLockFile: false);
 
     dependencies.add(new PackageRef(
         name, source, versionConstraint, description));
   });
 
   return dependencies;
-}
+}