W3C home > Mailing lists > Public > public-device-apis@w3.org > June 2011

[Battery Status Event Specification] Editorial feedback

From: Josh Soref <jsoref@rim.com>
Date: Tue, 28 Jun 2011 10:37:50 -0400
To: "public-device-apis@w3.org" <public-device-apis@w3.org>
Message-ID: <6A252AE18765C3468EF06946F24F0B571FFC12315F@XCH102CNC.rim.net>
So, I'm starting to read this specification [1], partially with my earlier comments in mind, but mostly to understand the proposal. Offhand I don't believe this proposal is compatible with the needs that I described in my earlier comments [2].

> The body element exposes as event handler content attribute the onbatterystatus event handler of the Window object.

<as event handler> doesn't work, one possible fix is this pair:
s/as/an/
s/attribute/attribute,/

another might be:
s/as/as an/

> When a change in the battery status of the hosting device occurs as follows,
> the user agent must dispatch a BatteryStatusEvent event on the Window [HTML5]
> and WorkerGlobalScope [WEBWORKERS] objects:
>    isPlugged changes its value, or
>    level varies by a 1% or more

This was too hard for me to read, I'd recommend restructuring the thing...

The user agent must dispatch a BatteryStatusEvent event on the Window [HTML5] and WorkerGlobalScope [WEBWORKERS] objects when a change in the battery status of the hosting device occurs as follows:

>    level varies by a 1% or more

s/varies/changes/
s/a 1% or more/at least 1%/

-- note that I don't think this is the right design for this specification, but this is just my editorial feedback pass :)


[1] http://dev.w3.org/2009/dap/system-info/battery-status.html 
[2] http://lists.w3.org/Archives/Public/public-device-apis/2011Jun/0080.html 

---------------------------------------------------------------------
This transmission (including any attachments) may contain confidential information, privileged material (including material protected by the solicitor-client or other applicable privileges), or constitute non-public information. Any use of this information by anyone other than the intended recipient is prohibited. If you have received this transmission in error, please immediately reply to the sender and delete this information from your system. Use, dissemination, distribution, or reproduction of this transmission by unintended recipients is not authorized and may be unlawful.
Received on Tuesday, 28 June 2011 14:38:31 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 9 May 2012 00:14:21 GMT