XHR review

Hi public-svg-wg,

this is my review of the XMLHttpRequest spec, 
http://www.w3.org/TR/2008/WD-XMLHttpRequest-20080415/.

2.2 Terminology
---------------

> The terms origin and event handler DOM attribute are defined by the HTML 5 specification. [HTML5]

Please provide links to the definitions of the terms 'origin' and 'event handler DOM attribute'.

4. The XMLHttpRequest Object
----------------------------

> This is the Document pointer.

If 'pointer' or 'Document pointer' is a term (which the styling seems to indicate) then please add it to section 2.2.

> The DONE state has an associated error flag which can be either "true" or "false". 
> The initial value of the error flag is "false".

Please consider adding a sentence saying that the "error flag" is not exposed through the XMLHttpRequest interface, it's an implementation (and specification) detail.

> If the response entity body is "null" return the empty string and terminate these steps.

Is that the string "null", or the value null, or perhaps even the empty string? This comment applies throughout the spec. Please define null as a term, and use that instead, with the same visual style as other terms (that is: without the quote-marks and in bold).

> This attribute is an event handler DOM attribute and must be invoked whenever a readystatechange event is targated at the object.

Typo: targated

Cheers
/Erik

-- 
Erik Dahlstrom, Core Technology Developer, Opera Software
Co-Chair, W3C SVG Working Group
Personal blog: http://my.opera.com/macdev_ed

Received on Tuesday, 3 June 2008 09:50:24 UTC