From ccbcea011a0d89f8c8902186ef9c75729d4ec65b Mon Sep 17 00:00:00 2001
From: Sam Day <me@samcday.com>
Date: Jan 07 2026 21:16:34 +0000
Subject: systemd: document gnome-session user unit exception


---

diff --git a/guidelines/modules/ROOT/pages/Scriptlets.adoc b/guidelines/modules/ROOT/pages/Scriptlets.adoc
index 7f9290a..3680ba9 100644
--- a/guidelines/modules/ROOT/pages/Scriptlets.adoc
+++ b/guidelines/modules/ROOT/pages/Scriptlets.adoc
@@ -341,6 +341,11 @@ These enable and disable user units according to presets,
 and are `+%systemd_user_post+` (to be used in `+%post+`)
 and `+%systemd_user_preun+` (to be used in `+%preun+`).
 
+User units that are driven by `gnome-session` *MUST NOT*
+be covered by the macros. These units are never enabled
+or disabled, but rather explicitly started/stopped by
+`gnome-session`.
+
 [source,rpm-spec]
 ----
 BuildRequires: systemd-rpm-macros