From 705cb712aebeb78f744c5f87d37ffa3a88e7ec12 Mon Sep 17 00:00:00 2001
From: Taylan Kammer <taylan.kammer@gmail.com>
Date: Fri, 10 Oct 2025 15:50:56 +0200
Subject: [PATCH] man/systemd.service: Improve OOMPolicy documentation (#39212)

---
 man/systemd.service.xml | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 68663e9ed81..125acae4d37 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -1271,11 +1271,13 @@
         <para>This setting takes one of <constant>continue</constant>, <constant>stop</constant> or
         <constant>kill</constant>. If set to <constant>continue</constant> and a process in the unit is
         killed by the OOM killer, this is logged but the unit continues running. If set to
-        <constant>stop</constant> the event is logged but the unit is terminated cleanly by the service
-        manager. If set to <constant>kill</constant> and one of the unit's processes is killed by the OOM
-        killer the kernel is instructed to kill all remaining processes of the unit too, by setting the
-        <filename>memory.oom.group</filename> attribute to <constant>1</constant>; also see kernel
-        page <ulink url="https://docs.kernel.org/admin-guide/cgroup-v2.html">Control Group v2</ulink>.
+        <constant>stop</constant> the event is logged and the unit's processes are terminated cleanly by the
+        service manager. If set to <constant>kill</constant> and one of the unit's processes is killed by the
+        OOM killer the kernel is instructed to kill all remaining processes of the unit too, by setting the
+        <filename>memory.oom.group</filename> attribute to <constant>1</constant>; also see kernel page
+        <ulink url="https://docs.kernel.org/admin-guide/cgroup-v2.html">Control Group v2</ulink>. In case of
+        both <constant>stop</constant> and <constant>kill</constant>, the service ultimately ends up in the
+        <constant>oom-kill</constant> failed state after which <varname>Restart=</varname> may apply.
         </para>
 
         <para>Defaults to the setting <varname>DefaultOOMPolicy=</varname> in
-- 
2.47.3