# This directory is a way to set environment variables that will be in
# effect throughout a Gnome-started Wayland session.  It is the result
# of a long debate (see the article https://lwn.net/Articles/709769/
# and the comment https://lwn.net/Articles/738407/ on that article).
#
# https://www.freedesktop.org/software/systemd/man/environment.d.html
# has more details, and you can probably do 'man environment.d'
# locally to see the same information too.  The TL;DR is:
#
#   - Files ending in '.conf' will be read.
#   - Give them numerical prefixes to control ordering.
#   - Assignments are VAR=VALUE (i.e., normal shell syntax)
#   - Right side can refer to an ${EXISTING_VALUE}
#   - ${FOO:-DEFAULT_VALUE} uses DEFAULT_VALUE if FOO would be empty
#   - ${FOO:+ALT_VALUE} uses ALT_VALUE if FOO would be non-empty
#   - Other shell syntax beyond the above is *not* supported, though.
#
# According to https://github.com/systemd/systemd/pull/5131,
# "environment generators" are now supported as described in
# https://github.com/systemd/systemd/pull/3904#issuecomment-273990606.
# I haven't looked into that yet, but maybe I'll need it some day.