W3C home > Mailing lists > Public > public-webapi@w3.org > June 2007

Re: Another XMLHttpRequest draft

From: Anne van Kesteren <annevk@opera.com>
Date: Thu, 28 Jun 2007 16:50:59 +0200
To: "denis sureau" <scriptet@gmail.com>, public-webapi@w3.org
Message-ID: <op.tumzi9ks64w2qv@annevk-t60.oslo.opera.com>

On Thu, 28 Jun 2007 12:36:01 +0200, denis sureau <scriptet@gmail.com>  
wrote:
> [...]

Fixed the typos.


> Not clear what you mean by bubbling:
>
>     ...is  dispatched on it during the bubbling phase

That term is defined in DOM Level 3 Events.


> Should not contain a "format" but a string instead:
>
>    If stored url just contains the "user" format let stored user be the  
> user part.

I don't understand this comment.


> Some commas may improve the readability:
>
>   If the user argument was not omitted and its syntax does not match that
> specified by the relevant authentication scheme raise a SYNTAX_ERR  
> exception and terminate these steps.

Done.


> By the "user" argument?
>
>    This step overrides any user that may have been set by the url  
> argument.

No, url argument is correct.


> "Method" word missing:
>
> Note that this algorithm might get aborted if the open() or abort() is
> invoked.

Added


> Wording:
>
>      If no Content-Type header is in the list of request  headers append  
> it to the list of request headers

Made more explicit.


> Comma required:
>
>    If the data argument has been omitted or is null no entity body is  
> used in the request.

Added


> "Error" word missing, and comma also:
>
>   In case of DNS errors or other type of networks run the following set  
> of steps.

Fixed both.


> I don't know if its regarded as a contribution but I have an advice. The
> removal of descriptions of the methods, replaced by just an algorithm is  
> not an improvement for some users, as students for example, that may use  
> the
> spec as a reference...

For those it's probably better if there's a tutorial from which they can  
copy & paste. The specification is primarily aimed at implementors.


-- 
Anne van Kesteren
<http://annevankesteren.nl/>
<http://www.opera.com/>
Received on Thursday, 28 June 2007 14:51:12 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:18:57 GMT