Revise doc comments.

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

Index: sdk/lib/_internal/pub/lib/src/entrypoint.dart
diff --git a/sdk/lib/_internal/pub/lib/src/entrypoint.dart b/sdk/lib/_internal/pub/lib/src/entrypoint.dart
index c766bc2e96f1e02f8f5b2999954fcbe3fe40d23e..80b2b530e3bd86228b58b2b4eca9516431708d98 100644
--- a/sdk/lib/_internal/pub/lib/src/entrypoint.dart
+++ b/sdk/lib/_internal/pub/lib/src/entrypoint.dart
@@ -108,9 +108,10 @@ class Entrypoint {
     return future;
   }
 
-  /// Gets all dependencies of the [root] package and places them in its
-  /// "packages" directory, respecting the [LockFile] if present. Returns a
-  /// [Future] that completes when all dependencies are available.
+  /// Gets all dependencies of the [root] package, respecting the [LockFile]
+  /// if present.
+  ///
+  /// Returns a [Future] that completes when all dependencies are available.
   Future getDependencies() {
     return new Future.sync(() {
       return resolveVersions(cache.sources, root, lockFile: loadLockFile());
@@ -118,16 +119,17 @@ class Entrypoint {
   }
 
   /// Gets the latest available versions of all dependencies of the [root]
-  /// package and places them in its "package" directory, writing a new
-  /// [LockFile]. Returns a [Future] that completes when all dependencies are
-  /// available.
+  /// package, writing a new [LockFile].
+  ///
+  /// Returns a [Future] that completes when all dependencies are available.
   Future upgradeAllDependencies() {
     return resolveVersions(cache.sources, root).then(_getDependencies);
   }
 
   /// Gets the latest available versions of [dependencies], while leaving
-  /// other dependencies as specified by the [LockFile] if possible. Returns a
-  /// [Future] that completes when all dependencies are available.
+  /// other dependencies as specified by the [LockFile] if possible.
+  ///
+  /// Returns a [Future] that completes when all dependencies are available.
   Future upgradeDependencies(List<String> dependencies) {
     return new Future.sync(() {
       return resolveVersions(cache.sources, root,