summaryrefslogtreecommitdiff
path: root/docs/DESKTOP_ENVIRONMENTS.md
diff options
context:
space:
mode:
authorBenjamin Berg <bberg@redhat.com>2020-07-20 10:45:48 +0200
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2020-07-20 12:46:56 +0200
commit6a097936b2408b743a6041629086b9e42ecd57b2 (patch)
tree6093288e6267dd667f1ba2de0ae9bc1a41f9ea17 /docs/DESKTOP_ENVIRONMENTS.md
parente6791b55228ede1eb90dfafbd927d60054c50bdb (diff)
downloadsystemd-6a097936b2408b743a6041629086b9e42ecd57b2.tar.gz
docs: Update section about XDG autostart generator
The generator is already merged. So update the corresponding section to describe the current status.
Diffstat (limited to 'docs/DESKTOP_ENVIRONMENTS.md')
-rw-r--r--docs/DESKTOP_ENVIRONMENTS.md22
1 files changed, 12 insertions, 10 deletions
diff --git a/docs/DESKTOP_ENVIRONMENTS.md b/docs/DESKTOP_ENVIRONMENTS.md
index 7c8331f9a9..0f66e31281 100644
--- a/docs/DESKTOP_ENVIRONMENTS.md
+++ b/docs/DESKTOP_ENVIRONMENTS.md
@@ -91,16 +91,18 @@ global default for all (graphical) applications.
## XDG autostart integration
-To allow XDG autostart integration, systemd will ship a cross-desktop generator
-to create appropriate units for the autostart directory.
-Desktop Environments will be able to make use of this simply by starting the
-appropriate XDG related targets (representing e.g. content of the
-`$XDG_CURRENT_DESKTOP` environment variable to handle `OnlyShowIn/NotShowIn`).
-The names and ordering rules for these targets are to be defined.
-
-This generator will likely never support certain desktop specific extensions.
-One such example is the GNOME specific feature to bind a service to a settings
-variable.
+To allow XDG autostart integration, systemd ships a cross-desktop generator
+to create appropriate units for the autostart directory
+(`systemd-xdg-autostart-generator`).
+Desktop Environments can opt-in to using this by starting
+`xdg-desktop-autostart.target`. The systemd generator correctly handles
+`OnlyShowIn=` and `NotShowin=`. It also handles the KDE and GNOME specific
+`X-KDE-autostart-condition=` and `AutostartCondition=` by using desktop
+environment provided binaries in an `ExecCondition=` line.
+
+However, this generator is somewhat limited in what it supports. For example,
+all generated units will have `After=graphical-session.target` set on them,
+it may therefore not be useful to start session services.
## Startup and shutdown best practices