aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2020-03-02 17:42:49 +0000
committerDaniel Eklöf <daniel@ekloef.se>2020-03-02 17:42:49 +0000
commit22ce09eb44db887d32a5b3a88740939b7285c763 (patch)
tree5f661d5d890b09ae335b4e7b8548cd76b7f2d862 /doc
parentinput: raise window 'move' timeout to 200ms (diff)
config: make CSD user configurable
The user can now configure the following: * Whether to prefer CSDs or SSDs. But note that this is only a hint to the compositor - it may deny our request. Furthermore, not all compositors implement the decoration manager protocol, meaning CSDs will be used regardless of the user configuration (GNOME/mutter being the most prominent one). * Title bar size and color, including transparency * Border size and color, including transparency Also drop support for rendering the CSDs inside the main surface.
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.5.scd31
1 files changed, 31 insertions, 0 deletions
diff --git a/doc/foot.5.scd b/doc/foot.5.scd
index 41785366..30fd735c 100644
--- a/doc/foot.5.scd
+++ b/doc/foot.5.scd
@@ -98,6 +98,37 @@ in this order:
Background translucency. A value in the range 0.0-1.0, where 0.0
means completely transparent, and 1.0 is opaque. Default: _1.0_.
+# SECTION: csd
+
+This section controls the look of the _CSDs_ (Client Side
+Decorations). Note that the default is to *not* use CSDs, but instead
+to use _SSDs_ (Server Side Decorations) when the compositor supports
+it.
+
+*preferred*
+ Which type of window decorations to prefer: *client* (CSD) or
+ *server* (SSD). Note that this is only a hint to the
+ compositor. Depending on the compositor's configuration and
+ capabilities, it may not have any effect. Default: _server_.
+
+*titlebar*
+ Height, in pixels (but subject to output scaling), of the
+ titlebar, not including the window border. Default: _26_.
+
+*border*
+ Width, in pixels (but subject to output scaling), of the
+ borders. Default: _5_.
+
+*titlebar-color*
+ Titlebar AARRGGBB color. Note that unlike the other color values,
+ the *titlebar-color* value also has an _alpha_ component. Default:
+ use the default _foreground_ color.
+
+*border-color*
+ Border AARRGGBB color. Note that unlike the other color values,
+ the *border-color* value also has an _alpha_ component. Default:
+ _transparent_.
+
# FONT FORMAT
The font is specified in FontConfig syntax. That is, a colon-separated