man: document that Type=idle is subject to a 5s time-out

Fixes: #4116

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index b58e8876623db7b3e42b3ee8bc3dbbebf54ea091..8203f2d52ed4d0216b3e2e8cd312a7e43d3b6acc 100644 (file)
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -209,11 +209,11 @@
         if used in combination with
         <varname>PrivateNetwork=</varname><option>yes</option>.</para>
 
-        <para>Behavior of <option>idle</option> is very similar to
-        <option>simple</option>; however, actual execution of the
-        service binary is delayed until all jobs are dispatched. This
-        may be used to avoid interleaving of output of shell services
-        with the status output on the console.</para>
+        <para>Behavior of <option>idle</option> is very similar to <option>simple</option>; however, actual execution
+        of the service binary is delayed until all active jobs are dispatched. This may be used to avoid interleaving
+        of output of shell services with the status output on the console. Note that this type is useful only to
+        improve console output, it is not useful as a general unit ordering tool, and the effect of this service type
+        is subject to a 5s time-out, after which the service binary is invoked anyway.</para>
         </listitem>
       </varlistentry>