Tweaks for documentation.

pkg/analyzer/lib/src/dart/analysis/driver.dart

Index: pkg/analyzer/lib/src/dart/analysis/driver.dart
diff --git a/pkg/analyzer/lib/src/dart/analysis/driver.dart b/pkg/analyzer/lib/src/dart/analysis/driver.dart
index 22c50a5ef58a8fcbe0d37ec9140c12c6634f59b7..85d2b396364d69ed68c2b01e52a6b9f107509ceb 100644
--- a/pkg/analyzer/lib/src/dart/analysis/driver.dart
+++ b/pkg/analyzer/lib/src/dart/analysis/driver.dart
@@ -198,8 +198,9 @@ class AnalysisDriver {
    *
    * At least one analysis result is produced for every file passed to
    * [addFile] or [changeFile] prior to the next time the analysis state
-   * transitions to "idle". Analysis results for other files are produced
-   * only if the changes affect analysis results of other files.
+   * transitions to "idle", unless the file is later removed from analysis
+   * using [removeFile]. Analysis results for other files are produced only if
+   * the changes affect analysis results of other files.
    *
    * More than one result might be produced for the same file, even if the
    * client does not change the state of the files.
@@ -708,7 +709,7 @@ class _File {
   final AnalysisDriver driver;
 
   /**
-   * The [Source] this [_File] instance represent.
+   * The [Source] this [_File] instance represents.
    */
   final Source source;