Bug 16299 - editorial - inadequate description of upload attribute
editorial - inadequate description of upload attribute
Status: CLOSED FIXED
Product: WebAppsWG
Classification: Unclassified
Component: XHR
unspecified
All All
: P2 normal
: ---
Assigned To: Anne
public-webapps-bugzilla
http://dvcs.w3.org/hg/xhr/raw-file/8d...
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2012-03-10 00:48 UTC by Glenn Adams
Modified: 2012-09-27 13:25 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Glenn Adams 2012-03-10 00:48:14 UTC
the update attribute needs to be better described to communicate a sense of
its intended purpose; at present, section 4.7.5 only says "The upload attribute must return the associated XMLHttpRequestUpload object."

it says nothing about the function of the XMLHttpRequestUpload object and why, for example, there needs to be two distinct XMLHttpRequestEventTargets;

furthermore, the spec should state that the upload objects are distinct across different XMLHttpRequest objects (at the moment, this seems merely to be assumed); i.e., each distinct XMLHttpRequestUpload object is associated with a distinct XMLHttpRequest object
Comment 1 Glenn Adams 2012-03-10 00:48:59 UTC
s/update/upload/g
Comment 2 Anne 2012-03-26 15:55:41 UTC
http://dvcs.w3.org/hg/xhr/rev/ba9735a82582

By the way, many thanks for all these reports!
Comment 3 Glenn Adams 2012-03-26 20:01:42 UTC
(In reply to comment #2)
> http://dvcs.w3.org/hg/xhr/rev/ba9735a82582

You added a note: "As indicated earlier, each XMLHttpRequest object has an associated XMLHttpRequestUpload object."

But this doesn't address my comment about whether XMLHttpRequestUpload objects are distinct or not; i.e., an implementer might (for whatever reason) reuse the same upload object on more than one request object. [You ask why? Because the spec allows this, or at least doesn't preclude this.]

It would be better if the word "distinct" were added in 4.7,  i.e.,

"Each XMLHttpRequest object also has a distinct, associated XMLHttpRequestUpload object."
Comment 5 Glenn Adams 2012-09-27 13:25:15 UTC
thanks