labwc/docs/labwc.1.scd
Johan Malm edc5338af4 Add command line option -C to specify config directory
Also expand usage message to explain what each option means
2022-04-22 17:00:36 +01:00

69 lines
1.7 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

labwc(1)
# NAME
labwc - A Wayland stacking compositor
# SYNOPSIS
*labwc*  [options...]
# DESCRIPTION
Labwc is a wlroots-based stacking compositor for Wayland.
It aims to be light-weight and independent, with a focus on simply
stacking windows well and rendering some window decorations. Where
practicable, it uses clients for wall-paper, panels, screenshots, and so
on.
# OPTIONS
*-c* <config-file>
Specify a config file with path
*-C* <config-directory>
Specify a config directory
*-d*
Enable full logging, including debug information
*-h*
Show help message and quit
*-s* <command>
Run command on startup
*-v*
Show the version number and quit
*-V*
Enable more verbose logging
# CONFIGURATION AND THEMING
Labwc uses openbox specification for configuration and theming, but does not
support all options. The the following files control the look and behaviour:
- ~/.config/labwc/rc.xml
- ~/.config/labwc/menu.xml
- ~/.config/labwc/autostart
- ~/.config/labwc/environment
- ~/.themes/<name>/openbox-3/themerc
Equivalent XDG Base Directory Specification locations are also honoured.
The configuration file and theme are re-loaded on receiving signal SIGHUP.
The autostart file is executed as a shell script. This is a place for setting a
background image, launching a panel, or similar.
The environment file is parsed as <variable>=<value> and sets environment
variables accordingly. It is recommended to specify keyboard settings here, for
example: `XKB_DEFAULT_LAYOUT=gb`. See xkeyboard-config(7) for details. Note
that the environment file is treated differently by openbox where it is simply
sourced prior to running openbox.
# SEE ALSO
labwc-config(5), labwc-theme(5), labwc-actions(5)