Update XMLHttpRequest documentation.

lib/html/doc/interface/HttpRequest.dartdoc

Index: lib/html/doc/interface/HttpRequest.dartdoc
===================================================================
--- lib/html/doc/interface/HttpRequest.dartdoc	(revision 11000)
+++ lib/html/doc/interface/HttpRequest.dartdoc	(working copy)
@@ -6,18 +6,22 @@
 //   This file contains documentation that is merged into the real source.
 //   Do not make code changes here.
 
+/**
+ * HttpRequest is Dart's name for the XMLHttpRequest object, as described below.

[sethladd, 2012/08/20 21:36:20]

How about a few sentences about what this class is used for, and a link over to
MDN?

[Emily Fortuna, 2012/08/20 21:40:15]

So if you look at the current page, it looks like the MDN info gets inserted,
I'm guessing where it says /// @domName XMLHttpRequest. Is that not correct?

[sethladd, 2012/08/20 21:43:32]

Oh, neat! Didn't realize we supported both.

+ */
+
 /// @domName XMLHttpRequest
-interface XMLHttpRequest extends EventTarget default _XMLHttpRequestFactoryProvider {
+interface HttpRequest extends EventTarget default _XMLHttpRequestFactoryProvider {
   // TODO(rnystrom): This name should just be "get" which is valid in Dart, but
   // not correctly implemented yet. (b/4970173)
-  XMLHttpRequest.get(String url, onSuccess(XMLHttpRequest request));
+  HttpRequest.get(String url, onSuccess(HttpRequest request));
 
-  XMLHttpRequest();
+  HttpRequest();
 
   /**
    * @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent
    */
-  XMLHttpRequestEvents get on();
+  HttpRequestEvents get on();
 
   static final int DONE = 4;
 
@@ -48,7 +52,7 @@
   String responseType;
 
   /** @domName XMLHttpRequest.responseXML */
-  final Document responseXML;
+  final Document responseXML; /*TODO(efortuna): rename, too?*/

[sra1, 2012/08/20 21:38:33]

No rename.  The response can be many things, including a blob or a string or an
XML document, so this is a good name.

 
   /** @domName XMLHttpRequest.status */
   final int status;
@@ -57,7 +61,7 @@
   final String statusText;
 
   /** @domName XMLHttpRequest.upload */
-  final XMLHttpRequestUpload upload;
+  final ttpRequestUpload upload;

[sethladd, 2012/08/20 21:36:20]

I think you mean RequestUpload here?

[sra1, 2012/08/20 21:38:33]

Typo HttpRequestUpload.

[Emily Fortuna, 2012/08/20 21:40:15]

Oops! I meant HttpRequestUpload.

 
   /** @domName XMLHttpRequest.withCredentials */
   bool withCredentials;
@@ -93,7 +97,7 @@
   void setRequestHeader(String header, String value);
 }
 
-interface XMLHttpRequestEvents extends Events {
+interface HttpRequestEvents extends Events {
 
   EventListenerList get abort();