FileWriter updated

I've rolled in feedback from the Device APIs and Policy WG [1], the
WebApps WG [2], and some private communications [reporting typo-level
errors] and posted a new draft [3].  In addition to trivial fixes, I
also took care of the following issues:

>From Anne van Kesteren:

> I think the exception on append() should move to setting the endings attribute.
> I.e. when setting endings to an unsupported value it > throws. It should throw
> a SYNTAX_ERR exception. That would be most compatible with similar attributes
> in HTML5. (Attributes limited to a known set of values.)

I've changed to SYNTAX_ERR, and the exception is now thrown where the
bad value is supplied.

For Dmitry Titov:

I cut the ending options to just two: transparent and native.  I've
left in the issue that we may want to drop ending conversion entirely,
but I've yet to hear consensus for that.

For Dmitry Titov and Kinuko Yasuda:

I've converted the endings attribute to a parameter to append().

For Robin Berjon:

Fixed up or added normative references top DOM3 events and progress events.
Clarified the description about what happens when the user requests an
unsupported ending conversion type.

For Darin Fisher and Jonas Sicking:

Added a contentType parameter to BlobBuilder.

For Kinuko Yasuda:

Added notes about obtaining a FileWriterSync.

The big unresolved issue at present is how one obtains a FileWriter
for its basic use (that is, where one is not using the FileSystem API
[4]).  I have some thoughts about this that I'll be posting in a fresh
thread.

    Eric

[1] http://lists.w3.org/Archives/Public/public-device-apis/2010Mar/0072.html
[whole thread]
[2] http://lists.w3.org/Archives/Public/public-webapps/2010JanMar/0910.html
[see later in the thread]
[3] http://dev.w3.org/2009/dap/file-system/file-writer.html
[4] http://dev.w3.org/2009/dap/file-system/file-dir-sys.html

Received on Wednesday, 28 April 2010 02:58:57 UTC