From: Lennart Poettering <lennart@poettering.net>
Date: Tue, 26 Mar 2019 17:02:49 +0000 (+0100)
Subject: man: document the new systemctl --show-transaction option
X-Git-Tag: v242-rc1~52^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F12115%2Fhead;p=thirdparty%2Fsystemd.git

man: document the new systemctl --show-transaction option
---

diff --git a/man/systemctl.xml b/man/systemctl.xml
index b5b9e077eeb..d991e979f15 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -299,6 +299,20 @@
 
       </varlistentry>
 
+      <varlistentry>
+        <term><option>-T</option></term>
+        <term><option>--show-transaction</option></term>
+
+        <listitem>
+          <para>When enqueuing a unit job (for example as effect of a <command>systemctl start</command>
+          invocation or similar), show brief information about all jobs enqueued, covering both the requested
+          job and any added because of unit dependencies. Note that the output will only include jobs
+          immediately part of the transaction requested. It is possible that service start-up program code
+          run as effect of the enqueued jobs might request further jobs to be pulled in. This means that
+          completion of the listed jobs might ultimately entail more jobs than the listed ones.</para>
+        </listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><option>--fail</option></term>