Document the fact that client must filter results from completion.results.

pkg/analysis_server/test/integration/integration_test_methods.dart

 // Copyright (c) 2014, 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.
 //
 // This file has been automatically generated.  Please do not edit it manually.
 // To regenerate the file, use the script
 // "pkg/analysis_server/spec/generate_files".
 
 /**
  * Convenience methods for running integration tests
@@ skipping 707 matching lines @@
    *   said identifier.
    *
    * replacementLength ( int )
    *
    *   The length of the text to be replaced if the remainder of the identifier
    *   containing the cursor is to be replaced when the suggestion is applied
    *   (that is, the number of characters in the existing identifier).
    *
    * results ( List<CompletionSuggestion> )
    *
-   *   The completion suggestions being reported.
+   *   The completion suggestions being reported. The notification contains all
+   *   possible completions at the requested cursor position, even those that
+   *   do not match the characters the user has already typed. This allows the
+   *   client to respond to further keystrokes from the user without having to
+   *   make additional requests.
    *
    * last ( bool )
    *
    *   True if this is that last set of results that will be returned for the
    *   indicated completion.
    */
   Stream onCompletionResults;
 
   /**
    * Stream controller for [onCompletionResults].
@@ skipping 702 matching lines @@
       case "debug.launchData":
         expect(params, isDebugLaunchDataParams);
         _onDebugLaunchData.add(params);
         break;
       default:
         fail('Unexpected notification: $event');
         break;
     }
   }
 }