summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBastien Nocera <hadess@hadess.net>2018-10-02 10:43:27 +0200
committerBastien Nocera <hadess@hadess.net>2018-10-02 10:48:07 +0200
commit0980b2dd4054a25c8f091f7b3a2f22e80ce61cd6 (patch)
tree85e98b9304aee13d64ec13fc03928150088aed4d
parent0a9d9ab4949effb20e77aa52e7b4ee07e776fc0d (diff)
docs: Mention to try and not use IconName when possible
See https://gitlab.freedesktop.org/upower/upower/merge_requests/16#note_41003
-rw-r--r--dbus/org.freedesktop.UPower.Device.xml3
1 files changed, 2 insertions, 1 deletions
diff --git a/dbus/org.freedesktop.UPower.Device.xml b/dbus/org.freedesktop.UPower.Device.xml
index 178fba3..d20f13e 100644
--- a/dbus/org.freedesktop.UPower.Device.xml
+++ b/dbus/org.freedesktop.UPower.Device.xml
@@ -745,7 +745,8 @@ method return sender=:1.386 -> dest=:1.477 reply_serial=2
<doc:doc>
<doc:description>
<doc:para>
- An icon name, following the <a href="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html">Icon Naming Specification</a>
+ <p>An icon name, following the <a href="http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html">Icon Naming Specification</a></p>
+ <p>Note that the icons might not match end-user expectations in terms of presentation relative to the amount of battery left or perceived to be left. It is recommended that front-ends use the BatteryLevel property first, if available, followed by the Percentage, to present a more realistic battery level to the user.</p>
</doc:para>
</doc:description>
</doc:doc>