rename threshold to low_threshold and document it properly

2 files changed, 8 insertions, 4 deletions

diff --git a/i3status.c b/i3status.c
index e812893..f0767a0 100644
--- a/i3status.c
+++ b/i3status.c
@@ -214,7 +214,7 @@ int main(int argc, char *argv[]) {
         cfg_opt_t battery_opts[] = {
                 CFG_STR("format", "%status %percentage %remaining", CFGF_NONE),
                 CFG_STR("path", "/sys/class/power_supply/BAT%d/uevent", CFGF_NONE),
-                CFG_INT("threshold", 10, CFGF_NONE),
+                CFG_INT("low_threshold", 10, CFGF_NONE),
                 CFG_BOOL("last_full_capacity", false, CFGF_NONE),
                 CFG_END()
         };
@@ -414,7 +414,7 @@ int main(int argc, char *argv[]) {
 
                         CASE_SEC_TITLE("battery") {
                                 SEC_OPEN_MAP("battery");
-                                print_battery_info(json_gen, buffer, atoi(title), cfg_getstr(sec, "path"), cfg_getstr(sec, "format"), cfg_getint(sec, "threshold"), cfg_getbool(sec, "last_full_capacity"));
+                                print_battery_info(json_gen, buffer, atoi(title), cfg_getstr(sec, "path"), cfg_getstr(sec, "format"), cfg_getint(sec, "low_threshold"), cfg_getbool(sec, "last_full_capacity"));
                                 SEC_CLOSE_MAP;
                         }
 
diff --git a/man/i3status.man b/man/i3status.man
index 7f88750..7df3d9d 100644
--- a/man/i3status.man
+++ b/man/i3status.man
@@ -72,7 +72,7 @@ ethernet eth0 {
 battery 0 {
         format = "%status %percentage %remaining %emptytime"
         path = "/sys/class/power_supply/BAT%d/uevent"
-        threshold = 10
+        low_threshold = 10
 }
 
 run_watch DHCP {
@@ -204,11 +204,15 @@ If your battery is represented in a non-standard path in /sys, be sure to
 modify the "path" property accordingly. The first occurence of %d gets replaced
 with the battery number, but you can just hard-code a path as well.
 
+If the remaining time sinks below low_threshold minutes, the battery text will
+be colored red. So, if you configure low_threshold to 10, and your battery
+lasts another 9 minutes, it will be colored red.
+
 *Example order*: +battery 0+
 
 *Example format*: +%status %remaining (%emptytime)+
 
-*Example threshold*: +threshold 10+
+*Example low_threshold*: +low_threshold 10+
 
 === CPU-Temperature