commit 5ac0925
wf
·
2026-05-02 13:09:02 +0000 UTC
parent fe4502f
Document window decorations
1 files changed,
+26,
-8
+26,
-8
1@@ -156,25 +156,43 @@ howlc(1) -- client to control the howl compositor
2
3 $ howlc modkey win+ctrl
4
5- * `focus_color`, `unfocus_color`:
6- Set the focused and unfocused colors of the window borders. Arguments are in the format of #RRGGBB,
7+ * `inner_focus_color`, `inner_unfocus_color`, `inner_unfocus_color`, `outer_unfocus_color`:
8+ Set the inner/outer focused and unfocused colors of the window borders. Arguments are in the format of #RRGGBB,
9 where the leading pound sign is optional. Note that in the format of #RRGGBB, the argument needs to
10 be quoted, since the pound sign (#) is a special one in most shells.
11
12 Example:
13
14- $ howlc focus_color "#f03937"
15+ $ howlc outer_focus_color "#f03937"
16
17- $ howlc unfocus_color eeeeee
18+ $ howlc inner_unfocus_color eeeeee
19
20- * `border_width`:
21- Set the window's border width. Argument is a single integer representing the new border width.
22+ * `inner_border_width`, `outer_border_width`:
23+ Set the window's inner/outer border width. Argument is a single integer representing the new border width.
24
25 Example:
26
27- $ howlc border_width 4
28+ $ howlc inner_border_width 4
29
30- $ howlc border_width 0
31+ $ howlc outer_border_width 0
32+
33+ * `title_format`:
34+ Set the format for the text displayed in window titlebars. Currently accepted specifiers are:
35+
36+ * `%t` - window title
37+ * `%a` - window app ID
38+ * `%p` - window PID
39+
40+ Example:
41+
42+ $ howlc title_format '%t %p'
43+
44+ * `set_decor`:
45+ Set the current window decoration theme. Argument is a path (absolute or relative) to the directory containing the theme. See decor.c on the format of themes.
46+
47+ Example:
48+
49+ $ howlc set_decor ~/etc/decorations/theme
50
51 * `quit`:
52 Quit the compositor.