id       = "spectrwm"
name     = "spectrwm"
homepage = "https://github.com/conformal/spectrwm"
description = "spectrwm is a small, dynamic tiling and reparenting window manager for X11."
executables   = ["spectrwm"]
platforms = ["linux"]

[dotfiles]

# spectrwm(1), CONFIGURATION FILES: the user file is looked for at
# "$XDG_CONFIG_HOME/spectrwm/spectrwm.conf", then
# "~/.config/spectrwm/spectrwm.conf (if $XDG_CONFIG_HOME is unset or empty)",
# then "~/.spectrwm.conf"; the FILES section lists "~/.spectrwm.conf" as
# "spectrwm user specific settings". The $XDG_CONFIG_DIRS, /etc/xdg and
# /etc/spectrwm.conf entries on the same page are the global copies, not
# user-level ones, and are left out.
#
# The first location is written as [configHome] because the man page names the
# variable rather than assuming ~/.config; the second is that same location's
# default and so is not listed twice. Both surviving entries are places a
# machine can actually be carrying the file.
paths = [
  "[configHome]/spectrwm/spectrwm.conf",
  "~/.spectrwm.conf",
]

exclude = []

# A spectrwm.conf is bindings, colours, layout and the programs bound to keys.
# spectrwm authenticates to nothing and writes no credential.
secret = []

# No machine_lines. `bar_action` names an external status script and
# `program[...]` names a command, either of which can be an absolute path on
# this host — but both are just as often a bare command name on $PATH, so a
# rule on them would strand a preference as often as it caught a machine
# detail. Colours, fonts, bindings and layout are what the user wants carried.