summaryrefslogtreecommitdiff
path: root/dbus
diff options
context:
space:
mode:
authorBastien Nocera <hadess@hadess.net>2017-10-19 17:19:15 +0200
committerBastien Nocera <hadess@hadess.net>2017-10-31 17:45:18 +0100
commitb9aaa05bc6bc5d40bd95b4f2fc7ef0d121879373 (patch)
treebf379fc8e132a4b9004602cd65817b6c20c85643 /dbus
parent296f5855d0c328d86893075b05acaa546ce52355 (diff)
downloadupower-b9aaa05bc6bc5d40bd95b4f2fc7ef0d121879373.tar.gz
docs: Better documentation for the BatteryLevel prop
https://bugs.freedesktop.org/show_bug.cgi?id=103361
Diffstat (limited to 'dbus')
-rw-r--r--dbus/org.freedesktop.UPower.Device.xml7
1 files changed, 6 insertions, 1 deletions
diff --git a/dbus/org.freedesktop.UPower.Device.xml b/dbus/org.freedesktop.UPower.Device.xml
index 4852ab0..178fba3 100644
--- a/dbus/org.freedesktop.UPower.Device.xml
+++ b/dbus/org.freedesktop.UPower.Device.xml
@@ -529,6 +529,10 @@ method return sender=:1.386 -> dest=:1.477 reply_serial=2
<doc:ref type="property" to="Source:Type">type</doc:ref>
has the value "battery".
</doc:para>
+ <doc:para>
+ The percentage will be an approximation if the <doc:ref type="property" to="BatteryLevel">battery level</doc:ref>
+ is set to something other than None. The percentage is kept for compatibility reasons.
+ </doc:para>
</doc:description>
</doc:doc>
</property>
@@ -707,7 +711,8 @@ method return sender=:1.386 -> dest=:1.477 reply_serial=2
<doc:doc>
<doc:description>
<doc:para>
- Level of the battery:
+ The level of the battery for devices which do not report a percentage but rather a coarse battery level. If the value
+ is None, then the device does not support coarse battery reporting, and the percentage should be used instead.
</doc:para>
<doc:list>
<doc:item>