Updated documentation for HttpRequest.

tools/dom/templates/html/impl/impl_XMLHttpRequest.darttemplate

 // Copyright (c) 2012, 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 $LIBRARYNAME;
 
  /**
   * A client-side XHR request for getting data from a URL,
   * formally known as XMLHttpRequest.
   *
@@ skipping 119 matching lines @@
         responseType: responseType,
         requestHeaders: requestHeaders, sendData: formData,
         onProgress: onProgress);
   }
 
   /**
    * Creates and sends a URL request for the specified [url].
    *
    * By default `request` will perform an HTTP GET request, but a different
    * method (`POST`, `PUT`, `DELETE`, etc) can be used by specifying the
-   * [method] parameter.
+   * [method] parameter. (See also [HttpRequest.postFormData] for `POST` 
+   * requests only.
    *
    * The Future is completed when the response is available.
    *
    * If specified, `sendData` will send data in the form of a [ByteBuffer],
    * [Blob], [Document], [String], or [FormData] along with the HttpRequest.
    *
+   * If specified, [responseType] sets the desired response format for the
+   * request. By default it is [String], but can also be 'arraybuffer', 'blob', 
+   * 'document', 'json', or 'text'. See also [HttpRequest.responseType] 
+   * for more information.
+   *
    * The [withCredentials] parameter specified that credentials such as a cookie
    * (already) set in the header or
    * [authorization headers](http://tools.ietf.org/html/rfc1945#section-10.2)
    * should be specified for the request. Details to keep in mind when using
    * credentials:
    *
    * * Using credentials is only useful for cross-origin requests.
    * * The `Access-Control-Allow-Origin` header of `url` cannot contain a wildcard (*).
    * * The `Access-Control-Allow-Credentials` header of `url` must be set to true.
    * * If `Access-Control-Expose-Headers` has not been set to true, only a subset of all the response headers will be returned when calling [getAllRequestHeaders].
@@ skipping 208 matching lines @@
         headers[key] = '${headers[key]}, $value';
       } else {
         headers[key] = value;
       }
     }
     return headers;
   }
 
 $!MEMBERS
 }