From d3e9f9a07fdb403fe69e42873bdc61df5924b85c Mon Sep 17 00:00:00 2001 From: Johan Malm Date: Fri, 7 Aug 2020 20:35:18 +0100 Subject: [PATCH] Update labwc(1) and labwc(5) --- docs/labwc.1.md | 33 ++++++++------------------------- docs/labwc.5.md | 22 ++++++++++++++++++++-- 2 files changed, 28 insertions(+), 27 deletions(-) diff --git a/docs/labwc.1.md b/docs/labwc.1.md index 3595ff3a..eed4cd2e 100644 --- a/docs/labwc.1.md +++ b/docs/labwc.1.md @@ -1,6 +1,6 @@ % labwc(1) % Johan Malm -% 18 July, 2020 +% 7 Aug, 2020 # NAME @@ -24,33 +24,16 @@ Labwc is a [WIP] free, stacking compositor for Wayland. It aims to be light-weig : Specify path to rc.xml -# CONFIGURATION FILES +# CONFIGURATION AND THEMES -If no file is specified using the -c option, the XDG Base Directory -Specification is adhered to using `labwc` in preference to `openbox`. +Labwc aims to be compatible with openbox configuration and theming, with the +following files control the look and behaviour: -Configuration files will be searched for in the following order: +- rc.xml +- themerc +- xbm icons -- `${XDG_CONFIG_HOME:-$HOME/.config}/labwc` -- `${XDG_CONFIG_DIRS:-/etc/xdg}/labwc` -- `${XDG_CONFIG_HOME:-$HOME/.config}/openbox` -- `${XDG_CONFIG_DIRS:-/etc/xdg}/openbox` - -See labwc(5) for rc.xml options. - -# THEME - -The theme engine aims to be compatible with openbox themes. - -Themes will be searched for in the following order: - -- `${XDG_DATA_HOME:-$HOME/.local/share}/themes` -- `$HOME/.themes` -- `/usr/share/themes` -- `/usr/local/share/themes` -- `/opt/share/themes` - -See labwc(5) for theme options. +See labwc(5) for details. # SEE ALSO diff --git a/docs/labwc.5.md b/docs/labwc.5.md index 8b2cded5..19f56dee 100644 --- a/docs/labwc.5.md +++ b/docs/labwc.5.md @@ -1,6 +1,6 @@ % labwc(5) % Johan Malm -% 6 Aug, 2020 +% 7 Aug, 2020 # NAME @@ -10,7 +10,16 @@ labwc - Configuration files There are two configuration files which control the look and behaviour of labwc, namely rc.xml and themerc. The configuration aims to be compatible with -Openbox, but there are some differences which are pointed out in this man page. +Openbox, but there are some differences which are pointed out throughout this +man page. + +Adhering to XDG Base Directory Specification, configuration files will be +searched for in the following order: + +- `${XDG_CONFIG_HOME:-$HOME/.config}/labwc` +- `${XDG_CONFIG_DIRS:-/etc/xdg}/labwc` +- `${XDG_CONFIG_HOME:-$HOME/.config}/openbox` +- `${XDG_CONFIG_DIRS:-/etc/xdg}/openbox` # RC.XML `` @@ -129,6 +138,15 @@ of tags specific to each action as defined below. # THEMERC +The theme engine aims to be compatible with openbox and themes will be +searched for in the following order: + +- `${XDG_DATA_HOME:-$HOME/.local/share}/themes//openbox-3/` +- `$HOME/.themes//openbox-3/` +- `/usr/share/themes//openbox-3/` +- `/usr/local/share/themes//openbox-3/` +- `/opt/share/themes//openbox-3/` + `window.active.title.bg.color` : Background for the focussed window's titlebar