summaryrefslogtreecommitdiff
path: root/man/i3status.man
diff options
context:
space:
mode:
authorTommie Gannert <tommie@gannert.se>2016-08-01 18:03:03 +0100
committerTommie Gannert <tommie@gannert.se>2016-08-28 14:29:08 +0100
commitdc072f9f5353dc8adab14b2de99f0c1abb25e8d8 (patch)
treec49efb14c7983dad7fa215d6d96d6edd56f9b30f /man/i3status.man
parentac8998ef03374abca56da9929812c6fcba936031 (diff)
Implement aggregates for batteries.
Using title number all, this enables aggregates. Note that FreeBSD and OpenBSD previously only reported aggregates, so this is bringing Linux and NetBSD that functionality. Changes the default battery reporting to the aggregate since most users probably don't care about individual batteries. For single-battery systems there should be no change. Fixes one obvious memory leak in NetBSD.
Diffstat (limited to 'man/i3status.man')
-rw-r--r--man/i3status.man12
1 files changed, 10 insertions, 2 deletions
diff --git a/man/i3status.man b/man/i3status.man
index d0ca2a0..cdde2aa 100644
--- a/man/i3status.man
+++ b/man/i3status.man
@@ -336,6 +336,10 @@ colored red. The low_threshold type can be of threshold_type "time" or
"percentage". So, if you configure low_threshold to 10 and threshold_type to
"time", and your battery lasts another 9 minutes, it will be colored red.
+To show an aggregate of all batteries in the system, use "all" as the number. In
+this case (for Linux), the /sys path must contain the "%d" sequence. Otherwise,
+the number indicates the battery index as reported in /sys.
+
Optionally custom strings including any UTF-8 symbols can be used for different
battery states. This makes it possible to display individual symbols
for each state (charging, discharging, unknown, full)
@@ -343,7 +347,9 @@ Of course it will also work with special iconic fonts, such as FontAwesome.
If any of these special status strings are omitted, the default (CHR, BAT, UNK,
FULL) is used.
-*Example order*: +battery 0+
+*Example order (for the first battery)*: +battery 0+
+
+*Example order (aggregate of all batteries)*: +battery all+
*Example format*: +%status %remaining (%emptytime %consumption)+
@@ -361,7 +367,9 @@ FULL) is used.
*Example threshold_type*: +time+
-*Example path*: +/sys/class/power_supply/CMB1/uevent+
+*Example path (%d replaced by title number)*: +/sys/class/power_supply/CMB%d/uevent+
+
+*Example path (ignoring the number)*: +/sys/class/power_supply/CMB1/uevent+
=== CPU-Temperature