Update doc comments to follow style guide.

sdk/lib/_internal/pub/lib/src/validator.dart

Index: sdk/lib/_internal/pub/lib/src/validator.dart
diff --git a/sdk/lib/_internal/pub/lib/src/validator.dart b/sdk/lib/_internal/pub/lib/src/validator.dart
index e4480581022eec14d98cd3f288c3c7e6c29d54dd..32194fec7ee0a98536167a83517eeba5d9240092 100644
--- a/sdk/lib/_internal/pub/lib/src/validator.dart
+++ b/sdk/lib/_internal/pub/lib/src/validator.dart
@@ -20,18 +20,24 @@ import 'validator/size.dart';
 import 'validator/utf8_readme.dart';
 
 /// The base class for validators that check whether a package is fit for
-/// uploading. Each validator should override [errors], [warnings], or both to
-/// return lists of errors or warnings to display to the user. Errors will cause
-/// the package not to be uploaded; warnings will require the user to confirm
-/// the upload.
+/// uploading.
+///
+/// Each validator should override [errors], [warnings], or both to return
+/// lists of errors or warnings to display to the user. Errors will cause the
+/// package not to be uploaded; warnings will require the user to confirm the
+/// upload.
 abstract class Validator {
   /// The entrypoint that's being validated.
   final Entrypoint entrypoint;
 
-  /// The accumulated errors for this validator. Filled by calling [validate].
+  /// The accumulated errors for this validator.
+  ///
+  /// Filled by calling [validate].
   final errors = <String>[];
 
-  /// The accumulated warnings for this validator. Filled by calling [validate].
+  /// The accumulated warnings for this validator.
+  ///
+  /// Filled by calling [validate].
   final warnings = <String>[];
 
   Validator(this.entrypoint);
@@ -41,8 +47,8 @@ abstract class Validator {
   Future validate();
 
   /// Run all validators on the [entrypoint] package and print their results.
-  /// The future will complete with the error and warning messages,
-  /// respectively.
+  ///
+  /// The future completes with the error and warning messages, respectively.
   ///
   /// [packageSize], if passed, should complete to the size of the tarred
   /// package, in bytes. This is used to validate that it's not too big to