Update doc comments to follow style guide.

sdk/lib/_internal/pub/lib/src/solver/solve_report.dart

 // Copyright (c) 2013, 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 pub.solver.solve_report;
 
 import '../lock_file.dart';
 import '../log.dart' as log;
 import '../package.dart';
 import '../source_registry.dart';
 import '../utils.dart';
 import 'version_solver.dart';
 
 /// Generates and displays nicely formatted reports for the results of running
 /// a version resolution.
 ///
 /// If [showAll] is true, then all of the previous and current dependencies
 /// are shown and their changes relative to the previous lock file are
 /// highlighted. Otherwise, only overrides are shown.
 ///
 /// Returns the number of changed dependencies.
 int show(SourceRegistry sources, Package root, LockFile previousLockFile,
          SolveResult result, {bool showAll: false}) {
   var report = new _SolveReport(sources, root, previousLockFile, result);
   return report.show(showAll: showAll);
 }
 
 /// Unlike [SolveResult], which is the static data describing a resolution,
 /// this class contains the mutable state used while generating the report
-/// itself. It's a report builder.
+/// itself.
+///
+/// It's a report builder.
 class _SolveReport {
   final SourceRegistry _sources;
   final Package _root;
   final LockFile _previousLockFile;
   final SolveResult _result;
 
   /// The dependencies in [_result], keyed by package name.
   final _dependencies = new Map<String, PackageId>();
 
   final _output = new StringBuffer();
@@ skipping 181 matching lines @@
   void _writeId(PackageId id) {
     _output.write(id.version);
 
     var source = _sources[id.source];
     if (source != _sources.defaultSource) {
       var description = source.formatDescription(_root.dir, id.description);
       _output.write(" from ${id.source} $description");
     }
   }
 }