Document HttpClientResponse data.

sdk/lib/io/http.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.
 
 part of dart.io;
 
 /**
  * HTTP status codes.
  */
 abstract class HttpStatus {
@@ skipping 826 matching lines @@
  *
  * The second future, which is returned by [:close:], completes with
  * an [HttpClientResponse] object when the response is received from
  * the server. This object contains the headers and body of the
  * response.
 
  * The future for [HttpClientRequest] is created by methods such as
  * [getUrl] and [open].
  *
  * When the HTTP response is ready a [HttpClientResponse] object is
- * provided which provides access to the headers and body of the response.
+ * provided which provides access to the headers and body of the response. The
+ * body is available as a stream implemented by [HttpClientResponse].
+ * If a body is present, it must be read. Otherwise, it'll lead to a resource
+ * leaks. Consider using [HttpClientResponse.drain] if the body is unused.
  *
  *     HttpClient client = new HttpClient();
  *     client.getUrl(Uri.parse("http://www.example.com/"))
  *         .then((HttpClientRequest request) {
  *           // Prepare the request then call close on it to send it.
  *           return request.close();
  *         })
  *         .then((HttpClientResponse response) {
  *          // Process the response.
  *         });
@@ skipping 527 matching lines @@
 
 class RedirectException implements HttpException {
   final String message;
   final List<RedirectInfo> redirects;
 
   const RedirectException(String this.message,
                           List<RedirectInfo> this.redirects);
 
   String toString() => "RedirectException: $message";
 }