Re: Updates to FileAPI

On Tue, Dec 21, 2010 at 11:31 AM, Arun Ranganathan <arun <at> mozilla.com> wrote:
> There are more rigid conformance requirements around lastModifiedDate.
>
> http://dev.w3.org/2006/webapi/FileAPI/#dfn-lastModifiedDate

"""
The last modified date of the file; on getting, this MUST return a
Date object [HTML5] with the last modified date on disk. On getting,
user agents MUST create a new Date object with the last modified date
on disk; a different Date object MUST be returned each time. On
getting, if user agents cannot make this information available, they
MUST return null; on getting, even if the user agent could make this
information available on previous gets, if it cannot make this
information available on the current access it MUST return null.
"""

This is worded really confusingly - there are 4 "on getting"s, and two
of the phrases are just duplicating information expressed in previous
phrases.  Can we get something clearer, like this:

"""
The last modified date of the file.  On getting, if user agents can
make this information available, this MUST return a fresh Date object
initialized to the last modified date of the file; otherwise, this
MUST return null.
"""

?

~TJ