2009/dap/system-info battery-status.html,1.37,1.38

Update of /sources/public/2009/dap/system-info
In directory hutz:/tmp/cvs-serv5260

Modified Files:
	battery-status.html 
Log Message:
editorial fixes

Index: battery-status.html
===================================================================
RCS file: /sources/public/2009/dap/system-info/battery-status.html,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- battery-status.html	24 Aug 2011 10:38:58 -0000	1.37
+++ battery-status.html	31 Aug 2011 10:37:52 -0000	1.38
@@ -81,9 +81,9 @@
         the web application with an assumption of sufficient battery level
         for the task at hand. This means the battery of a device may exhaust
         faster than desired because web developers are unable to make
-        decisions based on the battery status. With this knowledge of the
+        decisions based on the battery status. Given knowledge of the
         battery status, web developers are able to craft web content and
-        applications which are power efficient leading to improved user
+        applications which are power-efficient, thereby leading to improved user
         experience.
      </p>
      <p>
@@ -222,13 +222,13 @@
           Represents how much of the internal power source remains,
           scaled from 0 to 100. A value of 0 indicates that the
           system's battery is depleted, i.e. it is about to be
-          suspended. If the implementation is unable to report
+          suspended. If the implementation is unable to report the
           battery's level, then <code>level</code> MUST be
           set to <code>null</code>.
         </dd>
-        <dt>readonly attribute string? status</dt>
+        <dt>readonly attribute DOMString? status</dt>
         <dd>
-          One of <code>critical</code>, <code>low</code>, <code>ok</code>
+          One of <code>"critical"</code>, <code>"low"</code>, <code>"ok"</code>
           or <code>null</code>.
           Represents how much of the internal power source remains,
           scaled from <code>critical</code> to <code>ok</code>. The
@@ -236,7 +236,7 @@
           <code>ok</code> mirror the definitions of
           <a>batterycritical</a>, <a>batterylow</a> and <a>batteryok</a>
           events respectively. If the implementation is unable to
-          report battery's level, then status MUST be set to
+          report the battery's level, then status MUST be set to
           <code>null</code>.
         </dd>
         <dt>void initBatteryStatusEvent ()</dt>
@@ -245,12 +245,26 @@
             through the <code>DocumentEvent</code> interface 
             [[!DOM-LEVEL-3-EVENTS]].
           <dl class='parameters'>
-            <dt>DOMString type</dt><dd></dd>
-            <dt>boolean bubbles</dt><dd></dd>
-            <dt>boolean cancelable</dt><dd></dd>
-            <dt>boolean isPlugged</dt><dd></dd>
-            <dt>float? level</dt><dd></dd>
-            <dt>float? status</dt><dd></dd>
+            <dt>DOMString type</dt>
+            <dd>
+              The type of the event, which is one of <a>batterystatus</a>, <a>batterylow</a>,
+              <a>batterycritical</a> or <a>batteryok</a>.
+            </dd>
+            <dt>boolean bubbles</dt>
+            <dd>Whether the event will bubble, as defined in [[!DOM-LEVEL-3-EVENTS]].</dd>
+            <dt>boolean cancelable</dt>
+            <dd>Whether the event will be cancelable, as defined in [[!DOM-LEVEL-3-EVENTS]].</dd>
+            <dt>boolean isPlugged</dt>
+            <dd>Whether the device is plugged in or not.</dd>
+            <dt>float? level</dt>
+            <dd>
+              The level of the battery, between 0 and 100. Values inferior to 0 MUST cause <code>level</code> to be set to 0;
+              values superior to 100 MUST cause <code>level</code> to be set to 100.
+            </dd>
+            <dt>DOMString? status</dt>
+            <dd>
+              One of <code>"critical"</code>, <code>"low"</code>, <code>"ok"</code> or <code>null</code>.
+            </dd>
           </dl>
         </dd>
       </dl>
@@ -359,7 +373,7 @@
             the low battery condition is reached, and
           </li>
           <li>
-            the battery is depleting
+            the battery is depleting.
           </li>
         </ul>
         <p>
@@ -424,7 +438,7 @@
             the critically low battery condition is reached, and
           </li>
           <li>
-            the battery is depleting
+            the battery is depleting.
           </li>
         </ul>
         <p>
@@ -491,7 +505,7 @@
             the battery is plugged in, and
           </li>
           <li>
-            the battery is being charged or is at its full capacity
+            the battery is being charged or is at its full capacity.
           </li>
         </ul>
         <p>

Received on Wednesday, 31 August 2011 10:37:55 UTC