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

Re: [Battery Status Event Specification] Editorial feedback

From: Anssi Kostiainen <anssi.kostiainen@nokia.com>
Date: Wed, 29 Jun 2011 08:23:27 +0300
CC: "public-device-apis@w3.org" <public-device-apis@w3.org>
Message-ID: <4F779156-08F3-4C18-AEBC-8401065B9F38@nokia.com>
To: ext Josh Soref <jsoref@rim.com>
Hi,

On 28.6.2011, at 17.37, ext Josh Soref wrote:

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

Thanks for reviewing the spec. I've factored in your editorial comments, they're in the ED now.

The use cases described in [2] seem to be good candidates for the Battery Status Level 2 spec. The current spec is intentionally narrow in scope so that most UAs are able to implement all of it. A kind of a baseline to built upon.

(The scope of the spec was broader when we started, but we landed on the current narrower scope based on feedback.)

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

Fixed.

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

Fixed.

>>   level varies by a 1% or more
> 
> s/varies/changes/
> s/a 1% or more/at least 1%/

Fixed.

-Anssi

> [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 
Received on Wednesday, 29 June 2011 05:24:28 GMT

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