id       = "x11"
name     = "X11"
homepage = "https://www.x.org"
# The X.Org mark.
icon     = "SimpleIcons:xdotorg"
platforms = ["macos", "linux"]
# The client-side commands a user actually types to start a session or load
# resources. XQuartz ships the same ones on macOS, which is why that platform
# is listed beside Linux.
executables   = ["startx", "xinit", "xrdb", "xauth"]

[dotfiles]

# Two man pages between them name every file here.
#
# xinit(1), FILES: ".xinitrc" — "default client script" — and ".xserverrc" —
# "default server script", both read from the user's home directory, with
# built-in defaults (xterm and X) when they are absent. startx is the wrapper
# around xinit that everyone runs.
#
# xrdb(1), FILES: "xrdb does not load any files on its own, but many desktop
# environments use xrdb to load ~/.Xresources files on session startup to
# initialize the resource database, as a generalized replacement for
# ~/.Xdefaults files." Both spellings are listed because both are still read on
# the machines whose session scripts name them.
#
# All four are hard-coded in the home directory. None of this is a base
# directory, so none of it takes a placeholder.
paths = [
  "~/.xinitrc",
  "~/.xserverrc",
  "~/.Xresources",
  "~/.Xdefaults",
]

exclude = []

# xauth(1), FILES: "$HOME/.Xauthority — default authority file if XAUTHORITY
# isn't defined", holding "the authorization information used in connecting to
# the X server". The file is the credential: whoever has the cookie can talk to
# the display. It is also regenerated per session, so a consumer that refuses
# it loses nothing.
secret = ["~/.Xauthority"]

# No machine_lines. .Xresources is fonts, colours and DPI — preferences a user
# wants everywhere — and .xinitrc is the session the user chose to start.
# A DPI or an output name in either is a monitor's property rather than a
# named key a rule could reach, since both files are free-form.