Split labwc(5) into {-config, -theme, -actions}

docs/labwc-config.5.md

@@ -0,0 +1,112 @@
+% labwc-config(5)
+% Johan Malm
+% 31 Aug, 2020
+
+# NAME
+
+labwc - Configuration
+
+# CONFIGURATION
+
+The configuration aims to be compatible with Openbox, but there are some
+differences which are pointed out throughout the man pages.
+
+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`  
+
+# RC.XML `<lab>`
+
+Labwc specific settings which are not present in Openbox.
+
+    <lab>
+      <csd></csd>
+      <keyboard>
+        <layout></layout>
+      </keyboard>
+    </lab>
+
+`csd` (__boolean__; default no)
+
+:   Use client-side decorations for xdg-shell views.
+
+`keyboard-layout` (__string__; not set by default)
+
+:   Set `XKB_DEFAULT_LAYOUT`. See xkeyboard-config(7) for details.
+
+# RC.XML `<theme>`
+
+    <theme>
+      <name></name>
+      <font place="">
+        <name></name>
+        <size></size>
+      </font>
+    </theme>
+
+`name` (__string__; default Clearlooks)
+
+:   The name of the Openbox theme to use
+
+`font`
+
+:   The font to use for a specific element of a window, menu or OSD.
+
+    `place`
+
+    :   Can be `ActiveWindow` (titlebar of active window)
+
+    `name`
+
+    :   Describes font name (__string__; default sans)
+
+    `size`
+
+    :   Describes font size in pixels (__integer__; default 8)
+
+# RC.XML `<keyboard>`
+
+Describe key bindings.
+
+    <keyboard>
+      <keybind key="KEY-COMBINATION">
+        ACTION
+      </keybind>
+    <keyboard>
+
+`KEY-COMBINATION`
+
+:   The key combination to bind to an **ACTION** in the format
+    **modifier-key**, where supported **modifiers** include S (shift);
+    C (control); A (alt); W (super). Unlike Openbox, multiple space-separated
+    **KEY-COMBINATION** and key-chains are not supported.
+
+Example:
+
+    <keyboard>
+      <keybind key="A-Escape">
+        <action name="Exit"/>
+      </keybind>
+      <keybind key="A-Tab">
+        <action name="NextWindow"/>
+      </keybind>
+      <keybind key="A-F3">
+        <action name="Execute">
+          <command>dmenu_run</command>
+        </action>
+      </keybind>
+    <keyboard>
+
+Default:
+
+If no rc.xml file is found, the following default values will be used:
+
+- Alt+Escape: Exit labwc  
+- Alt+Tab: Cycle windows  
+- Alt+F3: Launch dmenu  
+
+# SEE ALSO
+
+labwc(1), labwc-actions(5), labwc-theme(5)