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>  
> [...]

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.


> 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.


> 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.


> "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
Received on Thursday, 28 June 2007 14:51:12 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:16:23 UTC