From 38bd60c4b3e70cb5584529358162f8b37d43669f Mon Sep 17 00:00:00 2001 From: Ryan Dwyer Date: Mon, 18 Mar 2019 21:23:28 +1000 Subject: [PATCH] Document the title_format command --- sway/sway.5.scd | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/sway/sway.5.scd b/sway/sway.5.scd index 4f4522fb..989717cb 100644 --- a/sway/sway.5.scd +++ b/sway/sway.5.scd @@ -265,6 +265,24 @@ set|plus|minus becomes fullscreen on the same workspace as the first container. In either of those cases, the second container will gain focus. +*title_format* + Sets the format of window titles. The following placeholders may be used: + + %title - The title supplied by the window + %app_id - The wayland app ID (applicable to wayland windows only) + %class - The X11 classname (applicable to xwayland windows only) + %instance - The X11 instance (applicable to xwayland windows only) + %shell - The protocol the window is using (typically xwayland or + xdg_shell) + + This command is typically used with *for_window* criteria. For example: + + for_window [title="."] title_format "%title (%app_id)" + + Note that markup requires pango to be enabled via the *font* command. + + The default format is "%title". + The following commands may be used either in the configuration file or at runtime. @@ -300,7 +318,7 @@ runtime. values in X11 (1=left, 2=middle, 3=right, 4=scroll up, 5=scroll down, 6=scroll left, 7=scroll right, 8=back, 9=forward). For the latter option, you can find the event names using _libinput debug-events_. - + _--whole-window_, _--border_, and _--exclude-titlebar_ are mouse-only options which affect the region in which the mouse bindings can be triggered. By default, mouse bindings are only triggered when over the title bar. With the