]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
docs: Update section about XDG autostart generator
authorBenjamin Berg <bberg@redhat.com>
Mon, 20 Jul 2020 08:45:48 +0000 (10:45 +0200)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Mon, 20 Jul 2020 10:46:56 +0000 (12:46 +0200)
The generator is already merged. So update the corresponding section to
describe the current status.

docs/DESKTOP_ENVIRONMENTS.md

index 7c8331f9a9b419fce10fd6f113b942a76b4c280c..0f66e3128130f5bba6f30480ccebc8d144a09994 100644 (file)
@@ -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