Regenerate pub sources.

sdk/lib/_internal/pub_generated/lib/src/git.dart

Index: sdk/lib/_internal/pub_generated/lib/src/git.dart
diff --git a/sdk/lib/_internal/pub_generated/lib/src/git.dart b/sdk/lib/_internal/pub_generated/lib/src/git.dart
index cd615073f6a92d6b0d988cea24cc2002b7e31c27..1e3291f0ef8c39f83953c623046fb0b6c18dc7f4 100644
--- a/sdk/lib/_internal/pub_generated/lib/src/git.dart
+++ b/sdk/lib/_internal/pub_generated/lib/src/git.dart
@@ -1,30 +1,55 @@
+// 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.
+
+/// Helper functionality for invoking Git.
 library pub.git;
+
 import 'dart:async';
 import 'dart:io';
+
 import 'package:stack_trace/stack_trace.dart';
+
 import 'exceptions.dart';
 import 'io.dart';
 import 'log.dart' as log;
 import 'utils.dart';
+
+/// An exception thrown because a git command failed.
 class GitException implements ApplicationException {
+  /// The arguments to the git command.
   final List<String> args;
+
+  /// The standard error emitted by git.
   final String stderr;
+
   String get message => 'Git error. Command: git ${args.join(" ")}\n$stderr';
-  GitException(Iterable<String> args, this.stderr) : args = args.toList();
+
+  GitException(Iterable<String> args, this.stderr)
+      : args = args.toList();
+
   String toString() => message;
 }
+
+/// Tests whether or not the git command-line app is available for use.
 bool get isInstalled {
   if (_isInstalledCache != null) return _isInstalledCache;
   _isInstalledCache = _gitCommand != null;
   return _isInstalledCache;
 }
 bool _isInstalledCache;
+
+/// Run a git process with [args] from [workingDir].
+///
+/// Returns the stdout as a list of strings if it succeeded. Completes to an
+/// exception if it failed.
 Future<List<String>> run(List<String> args, {String workingDir, Map<String,
     String> environment}) {
   if (!isInstalled) {
     fail(
         "Cannot find a Git executable.\n" "Please ensure Git is correctly installed.");
   }
+
   return runProcess(
       _gitCommand,
       args,
@@ -34,12 +59,15 @@ Future<List<String>> run(List<String> args, {String workingDir, Map<String,
     return result.stdout;
   });
 }
+
+/// Like [run], but synchronous.
 List<String> runSync(List<String> args, {String workingDir, Map<String,
     String> environment}) {
   if (!isInstalled) {
     fail(
         "Cannot find a Git executable.\n" "Please ensure Git is correctly installed.");
   }
+
   var result = runProcessSync(
       _gitCommand,
       args,
@@ -48,8 +76,12 @@ List<String> runSync(List<String> args, {String workingDir, Map<String,
   if (!result.success) throw new GitException(args, result.stderr.join("\n"));
   return result.stdout;
 }
+
+/// Returns the name of the git command-line app, or null if Git could not be
+/// found on the user's PATH.
 String get _gitCommand {
   if (_commandCache != null) return _commandCache;
+
   var command;
   if (_tryGitCommand("git")) {
     _commandCache = "git";
@@ -58,17 +90,22 @@ String get _gitCommand {
   } else {
     return null;
   }
+
   log.fine('Determined git command $command.');
   return _commandCache;
 }
 String _commandCache;
+
+/// Checks whether [command] is the Git command for this computer.
 bool _tryGitCommand(String command) {
+  // If "git --version" prints something familiar, git is working.
   try {
     var result = runProcessSync(command, ["--version"]);
     var regexp = new RegExp("^git version");
     return result.stdout.length == 1 && regexp.hasMatch(result.stdout.single);
   } on ProcessException catch (error, stackTrace) {
     var chain = new Chain.forTrace(stackTrace);
+    // If the process failed, they probably don't have it.
     log.message('Git command is not "$command": $error\n$chain');
     return false;
   }