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

utils/pub/pub.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.
 
-/**
- * The main entrypoint for the pub command line application.
- */
+/// The main entrypoint for the pub command line application.
 library pub;
 
 import '../../pkg/args/lib/args.dart';
 import '../../pkg/path/lib/path.dart' as path;
 import 'dart:io';
 import 'dart:math';
 import 'http.dart';
 import 'io.dart';
 import 'command_help.dart';
 import 'command_install.dart';
 import 'command_lish.dart';
 import 'command_update.dart';
 import 'command_uploader.dart';
 import 'command_version.dart';
 import 'entrypoint.dart';
 import 'exit_codes.dart' as exit_codes;
 import 'log.dart' as log;
 import 'package.dart';
 import 'pubspec.dart';
 import 'source.dart';
 import 'source_registry.dart';
 import 'system_cache.dart';
 import 'utils.dart';
 import 'version.dart';
 
 Version get pubVersion => new Version(0, 0, 0);
 
-/**
- * The commands that Pub understands.
- */
+/// The commands that Pub understands.
 Map<String, PubCommand> get pubCommands {
   var commands = {
     'help': new HelpCommand(),
     'install': new InstallCommand(),
     'publish': new LishCommand(),
     'update': new UpdateCommand(),
     'uploader': new UploaderCommand(),
     'version': new VersionCommand()
   };
   for (var command in commands.values) {
     for (var alias in command.aliases) {
       commands[alias] = command;
     }
   }
   return commands;
 }
 
-/**
- * The parser for arguments that are global to Pub rather than specific to a
- * single command.
- */
+/// The parser for arguments that are global to Pub rather than specific to a
+/// single command.
 ArgParser get pubArgParser {
   var parser = new ArgParser();
   parser.addFlag('help', abbr: 'h', negatable: false,
       help: 'Print this usage information.');
   parser.addFlag('version', negatable: false,
       help: 'Print pub version.');
   parser.addFlag('trace',
        help: 'Print debugging information when an error occurs.');
   parser.addOption('verbosity',
       help: 'Control output verbosity.',
@@ skipping 68 matching lines @@
     log.error('Run "pub help" to see available commands.');
     exit(exit_codes.USAGE);
     return;
   }
 
   var commandArgs =
       globalOptions.rest.getRange(1, globalOptions.rest.length - 1);
   command.run(cache, globalOptions, commandArgs);
 }
 
-/** Displays usage information for the app. */
+/// Displays usage information for the app. 
 void printUsage([String description = 'Pub is a package manager for Dart.']) {
   // Build up a buffer so it shows up as a single log entry.
   var buffer = new StringBuffer();
   buffer.add(description);
   buffer.add('\n\n');
   buffer.add('Usage: pub command [arguments]\n\n');
   buffer.add('Global options:\n');
   buffer.add('${pubArgParser.getUsage()}\n\n');
 
   // Show the commands sorted.
@@ skipping 25 matching lines @@
   log.message('Pub $pubVersion');
 }
 
 abstract class PubCommand {
   SystemCache cache;
   ArgResults globalOptions;
   ArgResults commandOptions;
 
   Entrypoint entrypoint;
 
-  /**
-   * A one-line description of this command.
-   */
+  /// A one-line description of this command.
   String get description;
 
-  /**
-   * How to invoke this command (e.g. `"pub install [package]"`).
-   */
+  /// How to invoke this command (e.g. `"pub install [package]"`).
   String get usage;
 
   /// Whether or not this command requires [entrypoint] to be defined. If false,
   /// Pub won't look for a pubspec and [entrypoint] will be null when the
   /// command runs.
   final requiresEntrypoint = true;
 
   /// Alternate names for this command. These names won't be used in the
   /// documentation, but they will work when invoked on the command line.
   final aliases = const <String>[];
 
-  /**
-   * Override this to define command-specific options. The results will be made
-   * available in [commandOptions].
-   */
+  /// Override this to define command-specific options. The results will be made
+  /// available in [commandOptions].
   ArgParser get commandParser => new ArgParser();
 
   void run(SystemCache cache_, ArgResults globalOptions_,
       List<String> commandArgs) {
     cache = cache_;
     globalOptions = globalOptions_;
 
     try {
      commandOptions = commandParser.parse(commandArgs);
     } on FormatException catch (e) {
@@ skipping 55 matching lines @@
       }
 
       handleError(e, future.stackTrace);
     });
 
     // Explicitly exit on success to ensure that any dangling dart:io handles
     // don't cause the process to never terminate.
     future.then((_) => exit(0));
   }
 
-  /**
-   * Override this to perform the specific command. Return a future that
-   * completes when the command is done or fails if the command fails. If the
-   * command is synchronous, it may return `null`.
-   */
+  /// Override this to perform the specific command. Return a future that
+  /// completes when the command is done or fails if the command fails. If the
+  /// command is synchronous, it may return `null`.
   Future onRun();
 
-  /** Displays usage information for this command. */
+  /// Displays usage information for this command. 
   void printUsage([String description]) {
     if (description == null) description = this.description;
 
     var buffer = new StringBuffer();
     buffer.add('$description\n\nUsage: $usage');
 
     var commandUsage = commandParser.getUsage();
     if (!commandUsage.isEmpty) {
       buffer.add('\n');
       buffer.add(commandUsage);
     }
 
     log.message(buffer.toString());
   }
 
   /// Returns the appropriate exit code for [exception], falling back on 1 if no
   /// appropriate exit code could be found.
   int _chooseExitCode(exception) {
     if (exception is HttpException || exception is HttpParserException ||
         exception is SocketIOException || exception is PubHttpException) {
       return exit_codes.UNAVAILABLE;
     } else if (exception is FormatException) {
       return exit_codes.DATA;
     } else {
       return 1;
     }
   }
 }