Re-land minor tweaks to the analyzer cli's usage text.

pkg/analyzer_cli/lib/src/options.dart

 // Copyright (c) 2015, 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 analyzer_cli.src.options;
 
 import 'dart:io';
 
 import 'package:analyzer/file_system/physical_file_system.dart';
 import 'package:analyzer/src/command_line/arguments.dart';
@@ skipping 332 matching lines @@
               'Specifies the path to the file where analysis results should be written.',
           hide: hide)
       ..addFlag('build-mode',
           // TODO(paulberry): add more documentation.
           help: 'Enable build mode.',
           defaultsTo: false,
           negatable: false,
           hide: hide)
       ..addOption('build-summary-input',
           help: 'Path to a summary file that contains information from a '
-              'previous analysis run.  May be specified multiple times.',
+              'previous analysis run; may be specified multiple times.',
           allowMultiple: true,
           hide: hide)
       ..addOption('build-summary-output',
           help: 'Specifies the path to the file where the full summary '
               'information should be written.',
           hide: hide)
       ..addOption('build-summary-output-semantic',
           help: 'Specifies the path to the file where the semantic summary '
               'information should be written.',
           hide: hide)
@@ skipping 28 matching lines @@
           help: 'Ignore unrecognized command line flags.',
           defaultsTo: false,
           negatable: false,
           hide: hide)
       ..addFlag('disable-cache-flushing', defaultsTo: false, hide: hide)
       ..addOption('x-perf-report',
           help: 'Writes a performance report to the given file (experimental).',
           hide: hide)
       ..addOption('x-package-warnings-prefix',
           help:
-              'Show warnings from package: imports that match the given prefix',
+              'Show warnings from package: imports that match the given prefix.',
           hide: hide)
       ..addFlag('enable-conditional-directives',
           help:
               'deprecated -- Enable support for conditional directives (DEP 40).',
           defaultsTo: false,
           negatable: false,
           hide: hide)
       ..addFlag('show-package-warnings',
           help: 'Show warnings from package: imports (deprecated).',
           defaultsTo: false,
@@ skipping 70 matching lines @@
         }
       } else if (results['persistent_worker']) {
         if (results.rest.isNotEmpty) {
           errorSink.writeln(
               'No source files expected in the persistent worker mode.');
           _showUsage(parser);
           exitHandler(15);
           return null; // Only reachable in testing.
         }
       } else if (results['version']) {
-        outSink.write('$_binaryName version ${_getVersion()}');
+        outSink.writeln('$_binaryName version ${_getVersion()}');
         exitHandler(0);
         return null; // Only reachable in testing.
       } else {
         if (results.rest.isEmpty && !results['build-mode']) {
           _showUsage(parser);
           exitHandler(15);
           return null; // Only reachable in testing.
         }
       }
       return new CommandLineOptions._fromArgs(results);
@@ skipping 10 matching lines @@
         'Usage: $_binaryName [options...] <directory or list of files>');
     errorSink.writeln('');
     errorSink.writeln(parser.usage);
     errorSink.writeln('');
     errorSink.writeln('''
 Run "dartanalyzer -h -v" for verbose help output, including less commonly used options.
 For more information, see http://www.dartlang.org/tools/analyzer.
 ''');
   }
 }