Document the title_format command

1 files changed, 19 insertions, 1 deletions

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 <amount>
 	becomes fullscreen on the same workspace as the first container. In either
 	of those cases, the second container will gain focus.
 
+*title_format* <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 "<b>%title</b> (%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