diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml
index 940395a442..2b1c20b96e 100644
--- a/man/systemd.resource-control.xml
+++ b/man/systemd.resource-control.xml
@@ -1077,9 +1077,20 @@ DeviceAllow=/dev/loop-control
Allows deprioritizing or omitting this unit's cgroup as a candidate when
systemd-oomd needs to act. Requires support for extended attributes (see
xattr7)
- in order to use or . Additionally,
- systemd-oomd will ignore these extended attributes if the unit's cgroup is not
- owned by the root user.
+ in order to use or .
+
+ When calculating candidates to relieve swap usage, systemd-oomd will
+ only respect these extended attributes if the unit's cgroup is owned by root.
+
+ When calculating candidates to relieve memory pressure, systemd-oomd
+ will only respect these extended attributes if the unit's cgroup owner, and the
+ owner of the monitored ancestor cgroup are the same. For example, if systemd-oomd
+ is calculating candidates for -.slice, then extended attributes set
+ on descendants of /user.slice/user-1000.slice/user@1000.service/
+ will be ignored because the descendants are owned by UID 1000, and -.slice
+ is owned by UID 0. But, if calculating candidates for
+ /user.slice/user-1000.slice/user@1000.service/, then extended attributes set
+ on the descendants would be respected.If this property is set to , the service manager will convey this to
systemd-oomd, which will only select this cgroup if there are no other viable