X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=i3status%2Fmanpage.html;h=af0e313b40653f9b8c249ba78a4d28b29bb3d31b;hb=HEAD;hp=88c009a21f81b6c537a22a150410ca94284edac3;hpb=d049fd68707996f65f358367c43fdde2b9d7e2b8;p=i3%2Fi3.github.io diff --git a/i3status/manpage.html b/i3status/manpage.html index 88c009a..af0e313 100644 --- a/i3status/manpage.html +++ b/i3status/manpage.html @@ -4,7 +4,7 @@ - + i3: i3status(1) @@ -32,11 +32,11 @@ document.addEventListener("DOMContentLoaded", function(){asciidoc.footnotes(); a

i3status(1)

Michael Stapelberg
<michael@i3wm.org>
-version 2.11, -January 2017 -
-
Table of Contents
- +version 2.12, +May 2018 +
+
Table of Contents
+
@@ -92,13 +92,12 @@ configuration files in the following order:

4. DESCRIPTION

-

i3status is a small program for generating a status bar for -i3bar, dzen2, xmobar, lemonbar or similar programs. It is designed to be very -efficient by issuing a very small number of system calls, as one generally -wants to update such a status line every second. This ensures that even under -high load, your status bar is updated correctly. Also, it saves a bit of energy -by not hogging your CPU as much as spawning the corresponding amount of shell -commands would.

+

i3status is a small program for generating a status bar for i3bar, dzen2, +xmobar, lemonbar or similar programs. It is designed to be very efficient by +issuing a very small number of system calls, as one generally wants to update +such a status line every second. This ensures that even under high load, your +status bar is updated correctly. Also, it saves a bit of energy by not hogging +your CPU as much as spawning the corresponding amount of shell commands would.

@@ -208,7 +207,7 @@ color, even when colors are disabled by the colors directive. This opti no effect when output_format is set to i3bar or none.

The interval directive specifies the time in seconds for which i3status will sleep before printing the next status line.

-

Using output_format you can chose which format strings i3status should +

Using output_format you can choose which format strings i3status should use in its output. Currently available are:

@@ -279,13 +278,13 @@ in a module section its value will override the value defined in the general section just for this module.

If you don’t fancy the vertical separators between modules i3status/i3bar uses by default, you can employ the separator directive to configure how -modules are separated. You can either disable the default separator altogether +modules are separated. You can also disable the default separator altogether by setting it to the empty string. You might then define separation as part of a module’s format string. This is your only option when using the i3bar output format as the separator is drawn by i3bar directly otherwise. For the other output formats, the provided non-empty string will be automatically enclosed with the necessary coloring bits if color support is enabled.

-

i3bar supports Pango markup, allowing your format strings to specify font +

i3bar supports Pango markup, allowing your format strings to specify font, color, size, etc. by setting the markup directive to "pango". Note that the ampersand ("&"), less-than ("<"), greater-than (">"), single-quote ("'"), and double-quote (""") characters need to be replaced with "&amp;", "&lt;", @@ -399,17 +398,20 @@ connected or not connected.

The special interface name _first_ will be replaced by the first wireless network interface found on the system (excluding devices starting with "lo").

Example order: wireless wlan0

-

Example format: W: (%quality at %essid, %bitrate / %frequency) %ip

+

Example format_up: W: (%quality at %essid, %bitrate / %frequency) %ip

+

Example format_down: W: down

5.7. Ethernet

Gets the IP address and (if possible) the link speed of the given ethernet -interface. Getting the link speed requires the cap_net_admin capability. Set -it using setcap cap_net_admin=ep $(which i3status).

+interface. If no IPv4 address is available and an IPv6 address is, it will be +displayed. Getting the link speed requires the cap_net_admin capability. +Set it using setcap cap_net_admin=ep $(which i3status).

The special interface name _first_ will be replaced by the first non-wireless network interface found on the system (excluding devices starting with "lo").

Example order: ethernet eth0

-

Example format: E: %ip (%speed)

+

Example format_up: E: %ip (%speed)

+

Example format_down: E: down

5.8. Battery

@@ -477,11 +479,13 @@ format when above max_threshold can be customized with format_above_threshold.

It is possible to define a degraded_threshold that will color the load value yellow in case the CPU average over the last interval is getting -higher than the configured threshold. Defaults to 90. The output format +higher than the configured threshold. Defaults to 90. The output format when above degraded threshold can be customized with format_above_degraded_threshold.

+

For displaying the Nth CPU usage, you can use the %cpu<N> format string, +starting from %cpu0. This feature is currently not supported in FreeBSD.

Example order: cpu_usage

-

Example format: %usage

+

Example format: all: %usage CPU_0: %cpu0 CPU_1: %cpu1

Example max_threshold: 75

Example format_above_threshold: Warning above threshold: %usage

Example degraded_threshold: 25

@@ -785,7 +789,9 @@ after changing the system volume, for example.