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

diff --git a/man/systemctl.xml b/man/systemctl.xml
index b5b9e077eeb7940b9cfa4011ac880f85ac80a465..d991e979f153e537a907fd78e0ad9f8fd9079a68 100644 (file)
--- 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>