man: document that ExecStop= is executed during restarts

Fixes: #7126

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 03cd14ceff01a5541a7f1ede33af2cb16de62a53..43c6435dcba15f90d6cd0833173a2c626a1a754e 100644 (file)
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -461,7 +461,9 @@
         start-up failed, for example because any of the commands specified in <varname>ExecStart=</varname>,
         <varname>ExecStartPre=</varname> or <varname>ExecStartPost=</varname> failed (and weren't prefixed with
         <literal>-</literal>, see above) or timed out. Use <varname>ExecStopPost=</varname> to invoke commands when a
-        service failed to start up correctly and is shut down again.</para>
+        service failed to start up correctly and is shut down again. Also note that, service restart requests are
+        implemented as stop operations followed by start operations. This means that <varname>ExecStop=</varname> and
+        <varname>ExecStopPost=</varname> are executed during a service restart operation.</para>
 
         <para>It is recommended to use this setting for commands that communicate with the service requesting clean
         termination. When the commands specified with this option are executed it should be assumed that the service is