Clean up command help.

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.
  */
 library pub;
 
 import '../../pkg/args/lib/args.dart';
@@ skipping 38 matching lines @@
   return commands;
 }
 
 /**
  * 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');
+      help: 'Print this usage information.');
   parser.addFlag('version', negatable: false,
-      help: 'print the version of pub');
+      help: 'Print pub version.');
   parser.addFlag('trace',
-       help: 'print debugging information when an error occurs');
+       help: 'Print debugging information when an error occurs.');
   parser.addOption('verbosity',
-      help: 'control output verbosity',
+      help: 'Control output verbosity.',
       allowed: ['normal', 'io', 'all'],
       allowedHelp: {
-        'normal': 'errors, warnings, and user messages are shown',
-        'io':     'IO operations are also shown',
-        'all':    'all output including internal tracing messages are shown'
+        'normal': 'Errors, warnings, and user messages are shown.',
+        'io':     'IO operations are also shown.',
+        'all':    'All output including internal tracing messages are shown.'
       });
   parser.addFlag('verbose', abbr: 'v', negatable: false,
-      help: 'shortcut for "--verbosity=all"');
+      help: 'Shortcut for "--verbosity=all"');
   return parser;
 }
 
 main() {
   var globalOptions;
   try {
     globalOptions = pubArgParser.parse(new Options().arguments);
   } on FormatException catch (e) {
     log.error(e.message);
     log.error('Run "pub help" to see available options.');
@@ skipping 206 matching lines @@
    * 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. */
   void printUsage([String description]) {
     if (description == null) description = this.description;
 
     var buffer = new StringBuffer();
-    buffer.add(description);
-    buffer.add('');
-    buffer.add('Usage: $usage');
+    buffer.add('$description\n\nUsage: $usage');
 
     var commandUsage = commandParser.getUsage();
     if (!commandUsage.isEmpty) {
-      buffer.add('');
+      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;
     }
   }
 }