chromeos: Add descriptions for power manager metrics.

tools/metrics/histograms/histograms.xml

 <!--
 Copyright 2013 The Chromium Authors. All rights reserved.
 Use of this source code is governed by a BSD-style license that can be
 found in the LICENSE file.
 -->
 
 <!--
 This file is used to generate a comprehensive list of Chrome histograms along
 with a detailed description for each histogram.
 
@@ skipping 6284 matching lines @@
   </summary>
 </histogram>
 
 <histogram name="Power.BatteryDischargeRate">
   <summary>
     Chrome OS battery discharge rate in mW sampled when the device runs on
     battery.
   </summary>
 </histogram>
 
+<histogram name="Power.BatteryDischargeRateWhileSuspended">
+  <summary>
+    Chrome OS battery discharge rate in mW while the system was suspended,

[Alexei Svitkine (slow), 2013/05/23 14:30:30]

Please specify units="mW" above, to get the right label in the graph. Also do
this for the histogram above.

[Daniel Erat, 2013/05/24 02:07:51]

Done.

+    sampled at resume.  Only reported if the system was on battery power both
+    before suspending and after resuming and if the energy level didn't increase
+    while suspended (which would indicate that an AC adapter was connected).
+  </summary>
+</histogram>
+
 <histogram name="Power.BatteryInfoSample" enum="BatteryInfoSampleResult">
   <summary>
     Counts the number of times we have read the battery status from sysfs and if
     it gave us sensible values.
   </summary>
 </histogram>
 
 <histogram name="Power.BatteryRemainingAtEndOfSessionOnAC" units="%">
   <summary>
     Chrome OS remaining battery charge as percent of the maximum battery charge,
@@ skipping 158 matching lines @@
   </summary>
 </histogram>
 
 <histogram name="Power.KernelSuspendTimeOnBattery" units="milliseconds">
   <summary>
     The time that the kernel took to suspend-to-RAM the Chrome OS device when
     running on battery.
   </summary>
 </histogram>
 
+<histogram name="Power.KeyboardBacklightLevel" units="%">
+  <summary>The level of the keyboard backlight as a percentage.</summary>

[Alexei Svitkine (slow), 2013/05/23 14:30:30]

Please mention when/how this is sampled.

Is it periodic, on startup / wake, etc?

[Daniel Erat, 2013/05/24 02:07:51]

Done.

+</histogram>
+
+<histogram name="Power.KeyboardBrightnessAdjust" enum="PowerBrightnessAdjust">
+  <summary>
+    Number of times the user has adjusted keyboard backlight brightness up and
+    down.
+  </summary>
+</histogram>
+
 <histogram name="Power.LengthOfSession" units="seconds">
   <summary>
     The length of time, in seconds, that a user spent in a single session.
     Values for this metric are clamped to 12 hours, so the last bucket should be
     considered to be including all metrics above 12 hours.
   </summary>
 </histogram>
 
 <histogram name="Power.MilliConsumptionPerHourIosOnActive">
   <summary>
@@ skipping 8823 matching lines @@
 <fieldtrial name="SSLResumption">
   <group name="Resume_Handshake" label="Session Resumption"/>
   <group name="Full_Handshake" label="Full"/>
   <affected-histogram name="Net.SSL_Connection_Latency"/>
   <affected-histogram name="Net.SSL_Connection_Latency_Google"/>
 </fieldtrial>
 
 </fieldtrials>
 
 </histogram-configuration>