Update XMLHttpRequest documentation.

Update XMLHttpRequest documentation.
Committed: https://code.google.com/p/dart/source/detail?r=11071

[Emily Fortuna, 2012-08-20 21:32:53]

My comment connecting HttpRequest to XMLHttpRequest is woefully bad. I'll
happily take suggestions on how to make it better. 

Also, should I have a similar comment of some sort in the other renamed classes
(HttpRequestUpload, HttpRequestProgressEvent, HttpRequestException)?

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

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
File lib/html/doc/interface/HttpRequest.dartdoc (right):

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
lib/html/doc/interface/HttpRequest.dartdoc:10: * HttpRequest is Dart's name for
the XMLHttpRequest object, as described below.
How about a few sentences about what this class is used for, and a link over to
MDN?

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
lib/html/doc/interface/HttpRequest.dartdoc:64: final ttpRequestUpload upload;
I think you mean RequestUpload here?

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

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
File lib/html/doc/interface/HttpRequest.dartdoc (right):

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
lib/html/doc/interface/HttpRequest.dartdoc:55: final Document responseXML;
/*TODO(efortuna): rename, too?*/
No rename.  The response can be many things, including a blob or a string or an
XML document, so this is a good name.

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
lib/html/doc/interface/HttpRequest.dartdoc:64: final ttpRequestUpload upload;
Typo HttpRequestUpload.

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

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
File lib/html/doc/interface/HttpRequest.dartdoc (right):

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
lib/html/doc/interface/HttpRequest.dartdoc:10: * HttpRequest is Dart's name for
the XMLHttpRequest object, as described below.
On 2012/08/20 21:36:20, sethladd wrote:
> How about a few sentences about what this class is used for, and a link over
to
> MDN?

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?

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
lib/html/doc/interface/HttpRequest.dartdoc:64: final ttpRequestUpload upload;
On 2012/08/20 21:36:20, sethladd wrote:
> I think you mean RequestUpload here?

Oops! I meant HttpRequestUpload.

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

lgtm

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
File lib/html/doc/interface/HttpRequest.dartdoc (right):

https://chromiumcodereview.appspot.com/10860050/diff/1/lib/html/doc/interface...
lib/html/doc/interface/HttpRequest.dartdoc:10: * HttpRequest is Dart's name for
the XMLHttpRequest object, as described below.
Oh, neat! Didn't realize we supported both.