From: Michael Stapelberg Date: Sun, 22 Dec 2013 20:28:31 +0000 (+0100) Subject: update docs for v4.7 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=87cee41137a38cc7025adc53c18810af31067213;p=i3%2Fi3.github.io update docs for v4.7 --- diff --git a/_docs/Makefile b/_docs/Makefile index 6d0e07a..926ff5d 100644 --- a/_docs/Makefile +++ b/_docs/Makefile @@ -1,5 +1,5 @@ -all: hacking-howto.html debugging.html debugging-release-version.html i3bar-protocol.html repositories.html buildbot.html userguide.html ipc.html multi-monitor.html wsbar.html i3status.html i3.html i3-config-wizard.html i3-nagbar.html i3-migrate-config-to-v4.html i3-msg.html testsuite.html gsoc2013-ideas.html +all: hacking-howto.html debugging.html debugging-release-version.html i3bar-protocol.html repositories.html buildbot.html userguide.html ipc.html multi-monitor.html wsbar.html i3status.html i3.html i3-config-wizard.html i3-nagbar.html i3-migrate-config-to-v4.html i3-msg.html testsuite.html gsoc2013-ideas.html tshirts.html gsoc2013-ideas.html: gsoc2013-ideas asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -a toc -n $< @@ -37,6 +37,9 @@ multi-monitor.html: multi-monitor wsbar.html: wsbar asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -a toc -n $< +tshirts.html: tshirts + asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -a toc -n $< + i3status.html: i3status.man asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -a toc -n $< diff --git a/_docs/hacking-howto b/_docs/hacking-howto index 73f8e88..bc59eae 100644 --- a/_docs/hacking-howto +++ b/_docs/hacking-howto @@ -97,21 +97,18 @@ Contains forward definitions for all public functions, as well as doxygen-compatible comments (so if you want to get a bit more of the big picture, either browse all header files or use doxygen if you prefer that). -src/cfgparse.l:: -Contains the lexer for i3’s configuration file, written for +flex(1)+. - -src/cfgparse.y:: -Contains the parser for i3’s configuration file, written for +bison(1)+. +src/config_parser.c:: +Contains a custom configuration parser. See src/command_parser.c for rationale + on why we use a custom parser. src/click.c:: Contains all functions which handle mouse button clicks (right mouse button clicks initiate resizing and thus are relatively complex). -src/cmdparse.l:: -Contains the lexer for i3 commands, written for +flex(1)+. - -src/cmdparse.y:: -Contains the parser for i3 commands, written for +bison(1)+. +src/command_parser.c:: +Contains a hand-written parser to parse commands (commands are what +you bind on keys and what you can send to i3 using the IPC interface, like +'move left' or 'workspace 4'). src/con.c:: Contains all functions which deal with containers directly (creating diff --git a/_docs/ipc b/_docs/ipc index 913899c..85e5e77 100644 --- a/_docs/ipc +++ b/_docs/ipc @@ -494,6 +494,8 @@ font (string):: The font to use for text on the bar. workspace_buttons (boolean):: Display workspace buttons or not? Defaults to true. +binding_mode_indicator (boolean):: + Display the mode indicator or not? Defaults to true. verbose (boolean):: Should the bar enable verbose output for debugging? Defaults to false. colors (map):: @@ -539,6 +541,7 @@ urgent_workspace_text/urgent_workspace_bar:: "status_command": "i3status", "font": "-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1", "workspace_buttons": true, + "binding_mode_indicator": true, "verbose": false, "colors": { "background": "#c0c0c0", diff --git a/_docs/userguide b/_docs/userguide index 76ac73a..666b962 100644 --- a/_docs/userguide +++ b/_docs/userguide @@ -252,7 +252,7 @@ workspace node. By default, the workspace node’s orientation is +horizontal+. Now you move one of these terminals down (+$mod+k+ by default). The workspace node’s orientation will be changed to +vertical+. The terminal window you moved down is directly attached to the workspace and appears on the bottom of the -screen. A new (horizontal) container was created to accomodate the other two +screen. A new (horizontal) container was created to accommodate the other two terminal windows. You will notice this when switching to tabbed mode (for example). You would end up having one tab called "another container" and the other one being the terminal window you moved down. @@ -446,7 +446,7 @@ New workspaces get a reasonable default orientation: Wide-screen monitors (anything higher than wide) get vertical orientation. With the +default_orientation+ configuration directive, you can override that -behaviour. +behavior. *Syntax*: ---------------------------------------------- @@ -834,7 +834,7 @@ popup_during_fullscreen smart When being in a tabbed or stacked container, the first container will be focused when you use +focus down+ on the last container -- the focus wraps. If however there is another stacked/tabbed container in that direction, focus will -be set on that container. This is the default behaviour so you can navigate to +be set on that container. This is the default behavior so you can navigate to all your windows without having to use +focus parent+. If you want the focus to *always* wrap and you are aware of using +focus @@ -900,7 +900,7 @@ workspace_auto_back_and_forth yes If an application on another workspace sets an urgency hint, switching to this workspace may lead to immediate focus of the application, which also means the -window decoration color would be immediately resetted to +client.focused+. This +window decoration color would be immediately reseted to +client.focused+. This may make it unnecessarily hard to tell which window originally raised the event. @@ -1180,11 +1180,32 @@ workspace_buttons -------------------------- *Example*: --------------------- +------------------------ bar { workspace_buttons no } --------------------- +------------------------ + +=== Binding Mode indicator + +Specifies whether the current binding mode indicator should be shown or not. +This is useful if you want to hide the workspace buttons but still be able +to see the current binding mode indicator. +For an example of a +mode+ definition, see <>. + +The default is to show the mode indicator. + +*Syntax*: +------------------------------- +binding_mode_indicator +------------------------------- + +*Example*: +----------------------------- +bar { + binding_mode_indicator no +} +----------------------------- === Colors @@ -1211,7 +1232,7 @@ inactive_workspace:: will be the case for most workspaces. urgent_workspace:: Border, background and text color for a workspace button when the workspace - window with the urgency hint set. + contains a window with the urgency hint set. Also applies to +mode+ indicators. *Syntax*: ---------------------------------------- @@ -1264,16 +1285,28 @@ bindsym $mod+x move container to workspace 3; workspace 3 [[command_criteria]] Furthermore, you can change the scope of a command - that is, which containers -should be affected by that command, by using various criteria. These are -prefixed in square brackets to every command. If you want to kill all windows -which have the class Firefox, use: +should be affected by that command, by using various criteria. The criteria +are specified before any command in a pair of square brackets and are separated +by space. + +When using multiple commands, separate them by using a +,+ (a comma) instead of +a semicolon. Criteria apply only until the next semicolon, so if you use a +semicolon to separate commands, only the first one will be executed for the +matched window(s). *Example*: ------------------------------------ +# if you want to kill all windows which have the class Firefox, use: bindsym $mod+x [class="Firefox"] kill # same thing, but case-insensitive bindsym $mod+x [class="(?i)firefox"] kill + +# kill only the About dialog from Firefox +bindsym $mod+x [class="Firefox" window_role="About"] kill + +# enable floating mode and move container to workspace 4 +for_window [class="^evil-app$"] floating enable, move container to workspace 4 ------------------------------------ The criteria which are currently implemented are: @@ -1554,7 +1587,7 @@ specify a default name if there's currently no workspace starting with a "1". You can rename workspaces. This might be useful to start with the default numbered workspaces, do your work, and rename the workspaces afterwards to reflect what’s actually on them. You can also omit the old name to rename -the currently focused workspace. This is handy if you wan't to use the +the currently focused workspace. This is handy if you want to use the rename command with +i3-input+. *Syntax*: @@ -1569,7 +1602,7 @@ i3-msg 'rename workspace 5 to 6' i3-msg 'rename workspace 1 to "1: www"' i3-msg 'rename workspace "1: www" to "10: www"' i3-msg 'rename workspace to "2: mail" -bindsym $mod+r exec i3-input -F 'rename workspace to %s' -P 'New name: ' +bindsym $mod+r exec i3-input -F 'rename workspace to "%s"' -P 'New name: ' -------------------------------------------------------------------------- === Moving workspaces to a different screen diff --git a/docs/hacking-howto.html b/docs/hacking-howto.html index 20fe064..3a23ff4 100644 --- a/docs/hacking-howto.html +++ b/docs/hacking-howto.html @@ -192,19 +192,12 @@ picture, either browse all header files or use doxygen if you prefer that).

-src/cfgparse.l +src/config_parser.c

-Contains the lexer for i3’s configuration file, written for flex(1). -

-
-
-src/cfgparse.y -
-
-

-Contains the parser for i3’s configuration file, written for bison(1). +Contains a custom configuration parser. See src/command_parser.c for rationale + on why we use a custom parser.

@@ -217,19 +210,13 @@ clicks initiate resizing and thus are relatively complex).

-src/cmdparse.l -
-
-

-Contains the lexer for i3 commands, written for flex(1). -

-
-
-src/cmdparse.y +src/command_parser.c

-Contains the parser for i3 commands, written for bison(1). +Contains a hand-written parser to parse commands (commands are what +you bind on keys and what you can send to i3 using the IPC interface, like +move left or workspace 4).

diff --git a/docs/i3status.html b/docs/i3status.html new file mode 100644 index 0000000..c4bccd5 --- /dev/null +++ b/docs/i3status.html @@ -0,0 +1,458 @@ + + + + + + +i3: i3status(1) + + + + + + + +
+

i3 - improved tiling WM

 + +
+
+ +
+

1. NAME

+
+

i3status - Generates a status line for dzen2 or xmobar

+
+
+
+

2. SYNOPSIS

+
+

i3status [-c configfile] [-h] [-v]

+
+
+
+

3. OPTIONS

+
+
+
+-c +
+
+

+Specifies an alternate configuration file path. By default, i3status looks for +configuration files in the following order: +

+
    +
  1. +

    +~/.i3status.conf +

    +
    2. +
  2. +

    +~/.config/i3status/config (or $XDG_CONFIG_HOME/i3status/config if set) +

    +
    3. +
  3. +

    +/etc/i3status.conf +

    +
    4. +
  4. +

    +/etc/xdg/i3status/config (or $XDG_CONFIG_DIRS/i3status/config if set) +

    +
    5. +
+
+
+
+
+
+

4. DESCRIPTION

+
+

i3status is a small program (about 1500 SLOC) for generating a status bar for +i3bar, dzen2, xmobar 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.

+
+
+
+

5. CONFIGURATION

+
+

The basic idea of i3status is that you can specify which "modules" should +be used (the order directive). You can then configure each module with its +own section. For every module, you can specify the output format. See below +for a complete reference.

+
+
Sample configuration
+
+
general {
+        output_format = "dzen2"
+        colors = true
+        interval = 5
+}
+
+order += "ipv6"
+order += "disk /"
+order += "run_watch DHCP"
+order += "run_watch VPN"
+order += "wireless wlan0"
+order += "ethernet eth0"
+order += "battery 0"
+order += "cpu_temperature 0"
+order += "load"
+order += "time"
+
+wireless wlan0 {
+        format_up = "W: (%quality at %essid, %bitrate) %ip"
+        format_down = "W: down"
+}
+
+ethernet eth0 {
+        # if you use %speed, i3status requires the cap_net_admin capability
+        format_up = "E: %ip (%speed)"
+        format_down = "E: down"
+}
+
+battery 0 {
+        format = "%status %percentage %remaining %emptytime"
+        path = "/sys/class/power_supply/BAT%d/uevent"
+        low_threshold = 10
+}
+
+run_watch DHCP {
+        pidfile = "/var/run/dhclient*.pid"
+}
+
+run_watch VPN {
+        pidfile = "/var/run/vpnc/pid"
+}
+
+time {
+        format = "%Y-%m-%d %H:%M:%S"
+}
+
+load {
+        format = "%5min"
+}
+
+cpu_temperature 0 {
+        format = "T: %degrees °C"
+        path = "/sys/devices/platform/coretemp.0/temp1_input"
+}
+
+disk "/" {
+        format = "%free"
+}
+
+
+

5.1. General

+

The colors directive will disable all colors if you set it to false. You can +also specify the colors that will be used to display "good", "degraded" or "bad" +values using the color_good, color_degraded or color_bad directives, +respectively. Those directives are only used if color support is not disabled by +the colors directive. The input format for color values is the canonical RGB +hexadecimal triplet (with no separators between the colors), prefixed by a hash +character ("#").

+

Example configuration:

+
+
+
color_good = "#00FF00"
+
+

Likewise, you can use the color_separator directive to specify the color that +will be used to paint the separator bar. The separator is always output in +color, even when colors are disabled by the colors directive.

+

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 +use in its output. Currently available are:

+
+
+i3bar +
+
+

+i3bar comes with i3 and provides a workspace bar which does the right thing in +multi-monitor situations. It also comes with tray support and can display the +i3status output. This output type uses JSON to pass as much meta-information to +i3bar as possible (like colors, which blocks can be shortened in which way, +etc.). +

+
+
+dzen2 +
+
+

+Dzen is a general purpose messaging, notification and menuing program for X11. +It was designed to be scriptable in any language and integrate well with window +managers like dwm, wmii and xmonad though it will work with any windowmanger +

+
+
+xmobar +
+
+

+xmobar is a minimalistic, text based, status bar. It was designed to work +with the xmonad Window Manager. +

+
+
+none +
+
+

+Does not use any color codes. Separates values by the pipe symbol. This should +be used with i3bar and can be used for custom scripts. +

+
+
+
+
+

5.2. IPv6

+

This module gets the IPv6 address used for outgoing connections (that is, the +best available public IPv6 address on your computer).

+

Example format_up: %ip

+

Example format_down no IPv6

+
+
+

5.3. Disk

+

Gets used, free, available and total amount of bytes on the given mounted filesystem.

+

These values can also be expressed in percentages with the percentage_used, +percentage_free, percentage_avail and percentage_used_of_avail formats.

+

Example order: disk /mnt/usbstick

+

Example format: %free (%avail)/ %total

+

Example format: %percentage_used used, %percentage_free free, %percentage_avail avail

+
+
+

5.4. Run-watch

+

Expands the given path to a pidfile and checks if the process ID found inside +is valid (that is, if the process is running). You can use this to check if +a specific application, such as a VPN client or your DHCP client is running.

+

Example order: run_watch DHCP

+

Example format: %title: %status

+
+
+

5.5. Wireless

+

Gets the link quality and ESSID of the given wireless network interface. You +can specify different format strings for the network being connected or not +connected.

+

Example order: wireless wlan0

+

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

+
+
+

5.6. 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).

+

Example order: ethernet eth0

+

Example format: E: %ip (%speed)

+
+
+

5.7. Battery

+

Gets the status (charging, discharging, running), percentage, remaining +time and power consumption (in Watts) of the given battery and when it’s +estimated to be empty. If you want to use the last full capacity instead of the +design capacity (when using the design capacity, it may happen that your +battery is at 23% when fully charged because it’s old. In general, I want to +see it this way, because it tells me how worn off my battery is.), just specify +last_full_capacity = true.

+

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.

+

It is possible to define a low_threshold that causes the battery text to be +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.

+

Example order: battery 0

+

Example format: %status %remaining (%emptytime %consumption)

+

Example low_threshold: 30

+

Example threshold_type: time

+
+
+

5.8. CPU-Temperature

+

Gets the temperature of the given thermal zone.

+

Example order: cpu_temperature 0

+

Example format: T: %degrees °C

+
+
+

5.9. CPU Usage

+

Gets the percentual CPU usage from /proc/stat (Linux) or sysctl(3) (FreeBSD/OpenBSD).

+

Example order: cpu_usage

+

Example format: %usage

+
+
+

5.10. Load

+

Gets the system load (number of processes waiting for CPU time in the last +1, 5 and 15 minutes).

+

Example order: load

+

Example format: %1min %5min %15min

+
+
+

5.11. Time

+

Formats the current system time. See strftime(3) for the format.

+

Example order: time

+

Example format: %Y-%m-%d %H:%M:%S

+
+
+

5.12. DDate

+

Outputs the current discordian date in user-specified format. See ddate(1) for +details on the format string. +Note: Neither %. nor %X are implemented yet.

+

Example order: ddate

+

Example format: %{%a, %b %d%}, %Y%N - %H

+
+
+

5.13. Volume

+

Outputs the volume of the specified mixer on the specified device. Works only +on Linux because it uses ALSA. +A simplified configuration can be used on FreeBSD and OpenBSD due to +the lack of ALSA, the device, mixer and mixder_idx options can be +ignored on these systems. On these systems the OSS API is used instead to +query /dev/mixer directly.

+

Example order: volume master

+

Example format: ♪: %volume

+

Example configuration:

+
+
+
volume master {
+        format = "♪: %volume"
+        device = "default"
+        mixer = "Master"
+        mixer_idx = 0
+}
+
+
+
+
+
+

6. Using i3status with dzen2

+
+

After installing dzen2, you can directly use it with i3status. Just ensure that +output_format is set to dzen2.

+

Example for usage of i3status with dzen2:

+
+
+
i3status | dzen2 -fg white -ta r -w 1280 \
+-fn "-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso8859-1"
+
+
+
+
+

7. Using i3status with xmobar

+
+

To get xmobar to start, you might need to copy the default configuration +file to ~/.xmobarrc. Also, ensure that the output_format option for i3status +is set to xmobar.

+

Example for usage of i3status with xmobar:

+
+
+
i3status | xmobar -o -t "%StdinReader%" -c "[Run StdinReader]"
+
+
+
+
+

8. What about memory usage or CPU frequency?

+
+

While talking about two specific things, please understand this section as a +general explanation why your favorite information is not included in i3status.

+

Let’s talk about memory usage specifically. It is hard to measure memory in a +way which is accurate or meaningful. An in-depth understanding of how paging +and virtual memory work in your operating system is required. Furthermore, even +if we had a well-defined way of displaying memory usage and you would +understand it, I think that it’s not helpful to repeatedly monitor your memory +usage. One reason for that is that I have not run out of memory in the last few +years. Memory has become so cheap that even in my 4 year old notebook, I have +8 GiB of RAM. Another reason is that your operating system will do the right +thing anyway: Either you have not enough RAM for your workload, but you need to +do it anyway, then your operating system will swap. Or you don’t have enough +RAM and you want to restrict your workload so that it fits, then the operating +system will kill the process using too much RAM and you can act accordingly.

+

For CPU frequency, the situation is similar. Many people don’t understand how +frequency scaling works precisely. The generally recommended CPU frequency +governor ("ondemand") changes the CPU frequency far more often than i3status +could display it. The display number is therefore often incorrect and doesn’t +tell you anything useful either.

+

In general, i3status wants to display things which you would look at +occasionally anyways, like the current date/time, whether you are connected to +a WiFi network or not, and if you have enough disk space to fit that 4.3 GiB +download.

+

However, if you need to look at some kind of information more than once in a +while (like checking repeatedly how full your RAM is), you are probably better +off with a script doing that, which pops up an alert when your RAM usage reaches +a certain threshold. After all, the point of computers is not to burden you +with additional boring tasks like repeatedly checking a number.

+
+
+
+

9. External scripts/programs with i3status

+
+

In i3status, we don’t want to implement process management again. Therefore, +there is no module to run arbitrary scripts or commands. Instead, you should +use your shell, for example like this:

+

Example for prepending the i3status output:

+
+
+
#!/bin/sh
+# shell script to prepend i3status with more stuff
+
+i3status | while :
+do
+        read line
+        echo "mystuff | $line" || exit 1
+done
+
+

Put that in some script, say .bin/my_i3status.sh and execute that instead of i3status.

+

Note that if you want to use the JSON output format (with colors in i3bar), you +need to use a slightly more complex wrapper script. There are examples in the +contrib/ folder, see http://code.i3wm.org/i3status/tree/contrib

+
+
+
+

10. SEE ALSO

+
+

strftime(3), date(1), glob(3), dzen2(1), xmobar(1)

+
+
+
+

11. AUTHORS

+
+

Michael Stapelberg and contributors

+

Thorsten Toepper

+

Baptiste Daroussin

+

Axel Wagner

+

Fernando Tarlá Cardoso Lemos

+
+
+
+
+ + + diff --git a/docs/index.html.mako b/docs/index.html.mako index b237a8a..84d114d 100644 --- a/docs/index.html.mako +++ b/docs/index.html.mako @@ -3,7 +3,7 @@ %> <%inherit file="_templates/i3.mako" />
-

Documentation for i3 v4.6

+

Documentation for i3 v4.7

One of i3’s goals is good documentation. The documents which you will find diff --git a/docs/ipc.html b/docs/ipc.html index f2ecf73..3b06485 100644 --- a/docs/ipc.html +++ b/docs/ipc.html @@ -872,6 +872,14 @@ workspace_buttons (boolean)

+binding_mode_indicator (boolean) +
+
+

+ Display the mode indicator or not? Defaults to true. +

+
+
verbose (boolean)
@@ -970,6 +978,7 @@ urgent_workspace_text/urgent_workspace_bar "status_command": "i3status", "font": "-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1", "workspace_buttons": true, + "binding_mode_indicator": true, "verbose": false, "colors": { "background": "#c0c0c0", diff --git a/docs/userguide.html b/docs/userguide.html index 45d0f03..004d8de 100644 --- a/docs/userguide.html +++ b/docs/userguide.html @@ -320,7 +320,7 @@ workspace node. By default, the workspace node’s orientation is horizontal

Now you move one of these terminals down ($mod+k by default). The workspace node’s orientation will be changed to vertical. The terminal window you moved down is directly attached to the workspace and appears on the bottom of the -screen. A new (horizontal) container was created to accomodate the other two +screen. A new (horizontal) container was created to accommodate the other two terminal windows. You will notice this when switching to tabbed mode (for example). You would end up having one tab called "another container" and the other one being the terminal window you moved down.

@@ -517,7 +517,7 @@ floating_maximum_size -1 x -1 (anything wider than high) get horizontal orientation, rotated monitors (anything higher than wide) get vertical orientation.

With the default_orientation configuration directive, you can override that -behaviour.

+behavior.

Syntax:

@@ -911,7 +911,7 @@ Leave fullscreen mode.

When being in a tabbed or stacked container, the first container will be focused when you use focus down on the last container — the focus wraps. If however there is another stacked/tabbed container in that direction, focus will -be set on that container. This is the default behaviour so you can navigate to +be set on that container. This is the default behavior so you can navigate to all your windows without having to use focus parent.

If you want the focus to always wrap and you are aware of using focus parent to switch to different containers, you can use the @@ -973,7 +973,7 @@ came from now, you can just press $mod+2 again to switch back to "1: www".

4.22. Delaying urgency hint reset on workspace change

If an application on another workspace sets an urgency hint, switching to this workspace may lead to immediate focus of the application, which also means the -window decoration color would be immediately resetted to client.focused. This +window decoration color would be immediately reseted to client.focused. This may make it unnecessarily hard to tell which window originally raised the event.

In order to prevent this, you can tell i3 to delay resetting the urgency state @@ -1256,7 +1256,27 @@ you want to display a statusline-only bar containing additional information.

-

5.10. Colors

+

5.10. Binding Mode indicator

+

Specifies whether the current binding mode indicator should be shown or not. +This is useful if you want to hide the workspace buttons but still be able +to see the current binding mode indicator. +For an example of a mode definition, see [resizingconfig].

+

The default is to show the mode indicator.

+

Syntax:

+
+
+
binding_mode_indicator <yes|no>
+
+

Example:

+
+
+
bar {
+    binding_mode_indicator no
+}
+
+
+
+

5.11. Colors

As with i3, colors are in HTML hex format (#rrggbb). The following colors can be configured at the moment:

@@ -1320,7 +1340,7 @@ urgent_workspace

Border, background and text color for a workspace button when the workspace - window with the urgency hint set. + contains a window with the urgency hint set. Also applies to mode indicators.

@@ -1375,16 +1395,27 @@ the following keybinding:

bindsym $mod+x move container to workspace 3; workspace 3

Furthermore, you can change the scope of a command - that is, which containers -should be affected by that command, by using various criteria. These are -prefixed in square brackets to every command. If you want to kill all windows -which have the class Firefox, use:

+should be affected by that command, by using various criteria. The criteria +are specified before any command in a pair of square brackets and are separated +by space.

+

When using multiple commands, separate them by using a , (a comma) instead of +a semicolon. Criteria apply only until the next semicolon, so if you use a +semicolon to separate commands, only the first one will be executed for the +matched window(s).

Example:

-
bindsym $mod+x [class="Firefox"] kill
+
# if you want to kill all windows which have the class Firefox, use:
+bindsym $mod+x [class="Firefox"] kill
 
 # same thing, but case-insensitive
-bindsym $mod+x [class="(?i)firefox"] kill

+bindsym $mod+x [class="(?i)firefox"] kill
+
+# kill only the About dialog from Firefox
+bindsym $mod+x [class="Firefox" window_role="About"] kill
+
+# enable floating mode and move container to workspace 4
+for_window [class="^evil-app$"] floating enable, move container to workspace 4

The criteria which are currently implemented are:

@@ -1733,7 +1764,7 @@ specify a default name if there’s currently no workspace starting with a "

You can rename workspaces. This might be useful to start with the default numbered workspaces, do your work, and rename the workspaces afterwards to reflect what’s actually on them. You can also omit the old name to rename -the currently focused workspace. This is handy if you wan’t to use the +the currently focused workspace. This is handy if you want to use the rename command with i3-input.

Syntax:

@@ -1748,7 +1779,7 @@ rename workspace to <new_name> i3-msg 'rename workspace 1 to "1: www"' i3-msg 'rename workspace "1: www" to "10: www"' i3-msg 'rename workspace to "2: mail" -bindsym $mod+r exec i3-input -F 'rename workspace to %s' -P 'New name: ' +bindsym $mod+r exec i3-input -F 'rename workspace to "%s"' -P 'New name: '
diff --git a/downloads/RELEASE-NOTES-4.7.txt b/downloads/RELEASE-NOTES-4.7.txt new file mode 100644 index 0000000..99c3dc1 --- /dev/null +++ b/downloads/RELEASE-NOTES-4.7.txt @@ -0,0 +1,82 @@ + + ┌──────────────────────────────┐ + │ Release notes for i3 v4.7 │ + └──────────────────────────────┘ + +This is the i3 v4.7. This version is considered stable. All users of i3 are +strongly encouraged to upgrade. + +This release features a number of documentation improvements, better error +messages in various places, better tray compatibility in i3bar, and a number of +bugfixes. + +Relevant from a packaging point of view is that we have switched to the new +xcb-util-cursor library to get rid of libXcursor. The last remaining big piece +of Xlib code now is XKB, which we may be able to tackle in upcoming releases +thanks to the just released libxcb 1.10. + + ┌────────────────────────────┐ + │ Changes in v4.7 │ + └────────────────────────────┘ + + • docs/userguide: clarify variable parsing + • docs/userguide: clarify urgent_workspace + • docs/userguide: add proper quoting for rename sample command + • docs/userguide: clarify multiple criteria + • docs/userguide: userguide: explain the difference between comma and semicolon for command chaining + • docs/hacking-howto: update to reflect parser changes + • man/i3-dump-log: document -f + • switch from libXcursor to xcb-util-cursor + • Respect workspace numbers when looking for a free workspace name + • Revert "raise fullscreen windows on top of all other X11 windows" + • i3bar: Create pixmaps using the real bar height, rather than screen height + • Add scratchpad bindings to the default config + • Close all children when closing a workspace + • i3bar: Add new bar.binding_mode_indicator configuration + • Improve error message when $XDG_RUNTIME_DIR is not writable + • libi3/font: Draw the text at the expected place + • libi3/font: Set DPI for the pango context + • Add ability to escape out of a mouse-resize operation + • Do not resize/reposition floating containers when moving them to scratchpad + • i3-nagbar: Set button inner-width to the width of the label + • Assigned windows open urgent when not visible + • i3bar: Only configure tray on own outputs + • Command 'move ' moves across outputs + • i3bar: Handle DestroyNotify events + • i3bar: Realign tray clients on map/unmap notify + • i3bar: Group child processes for signalling + • i3bar: Print error message when status_command fails + • Remove references to PATH_MAX macro for GNU/Hurd + + ┌────────────────────────────┐ + │ Bugfixes │ + └────────────────────────────┘ + + • update root geometry on output changes for “fullscreen global” + • don’t flatten tabbed/stacked containers + • Fix handling of new windows with WM_STATE_FULLSCREEN + • correctly recognize assigned windows as urgent + • Fix keyboard and mouse resize in nested containers + • Reply to _NET_REQUEST_FRAME_EXTENTS correctly + • Fix command parser: resizing tiling windows + • Fix output retrieval for floating cons + • Use _PATH_BSHELL to ensure using a bourne shell + • Instead of crashing, return DRAG_ABORT on UnmapNotify from drag_pointer + • Remove-child callback skips output content cons + • ignore _NET_ACTIVE_WINDOW for scratchpad windows + + ┌────────────────────────────┐ + │ Thanks! │ + └────────────────────────────┘ + +Thanks for testing, bugfixes, discussions and everything I forgot go out to: + +Alexander Neumann, badboy, Baptiste Daroussin, Bas Pape, Deiz, Franck Michea, +Jean-Philippe Ouellet, jj, jookia, kaersten, Lancelot SIX, Leo Gaspard, +mistnim, Peter Maatman, Quentin Glidic, Sebastian Ullrich, Slava, syl20bnr, +Tony Crisci, Trung Ngo, Vivien Didelot, Xarthisius + +I want to specifically thank Tony Crisci for the very valuable help with +responding to bugreports in our bugtracker. Thank you! + +-- Michael Stapelberg, 2013-12-22 diff --git a/index.html.mako b/index.html.mako index 535a5a2..bf2fab2 100644 --- a/index.html.mako +++ b/index.html.mako @@ -20,7 +20,7 @@ ➡ Download the latest version - 4.6 + 4.7