From 6a097936b2408b743a6041629086b9e42ecd57b2 Mon Sep 17 00:00:00 2001 From: Benjamin Berg Date: Mon, 20 Jul 2020 10:45:48 +0200 Subject: [PATCH] docs: Update section about XDG autostart generator The generator is already merged. So update the corresponding section to describe the current status. --- docs/DESKTOP_ENVIRONMENTS.md | 22 ++++++++++++---------- 1 file 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 -- 2.25.1