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.